HP 3000 Computer Systems 



MPE V Tables Manual for MPE V/E, Version G.00.00 




HP 3000 Computer Systems 



MPE V TABLES MANUAL 
for MPE V/E, Version G.00.00 




HEWLETT 

PACKARD 



19447 PRUNERIDGE AVENUE, CUPERTINO, CA 95014 



Part No. 32033-90010 
E2412 



Printed in U.S.A. 09/84 



CAUTION 



The normal checks and limitations that apply to the 
standard MPE users are bypassed in Privileged Mode. It 
is possible for a Privileged Mode program to destroy file 
integrity including the MPE operating system software 
itself. Upon request Hewlett-Packard will investigate 
and attempt to resolve problems resulting from the use 
of Privileged Mode code. This service is available on a 
time and materials billing basis. However, 
Hewlett-Packard will not support, correct, or attend to 
any modifications of the MPE operating system 
software. 



NOTICE 

The information contained in this manual is proprietary and may not be disclosed to third 
parties. The terms and conditions of release of this information to the recipient are 
governed by the agreement executed at and between Hewlett-Packard and the recipient 
regarding the HP 3000 internal MPE V System Table Structures, including the MPE V 
Tables Manual for MPE V Operating System. 

Hewlett-Packard, does not warrant the accuracy or completeness of the information con- 
tained in this manual. Hewlett-Packard may make revisions to the MPE operating system 
or CPU firmware that may affect the information and specifications contained herein. 
Hewlett-Packard shall have no obligation to provide the recipient with notification of 
revisions, corrections, or updates regarding the information contained herein. 

Hewlett-Packard shall not be responsible for any loss or damage to the recipient, its cus- 
tomers, or any third party caused by the recipient's use of the information provided 
herein. 
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PREFACE 



This manual describes the internal table organization of the MPE V operating system, 
release G.00.00. The Tables Manual is an informational reference for the technically 
sophisticated user with Privilege Mode capability. We strongly discourage modifying the 
table structure because you may destroy the operating system. The following caution 
applies : 



CAUTION 



The normal checks and limitations that apply to the 
standard MPE users are bypassed in Privileged Mode. It 
is possible for a Privileged Mode program to destroy file 
integrity including the MPE operating system software 
itself. Upon request Hewlett-Packard will investigate 
and attempt to resolve problems resulting from the use 
of Privileged Mode code. This service is available on a 
time and materials billing basis. However, 
Hewlett-Packard will not support, correct, or attend to 
any modifications of the MPE operating system 
software. 



The table structure of MPE V is significantly expanded from MPE IV. The operating sys- 
tem reflected in the table structure is the Fundamental Operating Software (FOS) version 
of MPE V. Your table structure may look different depending on the applications and uses 
of your system . 

The information is presented in several different formats. This reflects the combined 
knowledge of several divisions and groups within Hewlett-Packard. Instead of taking the 
time to consolidate all the various formats, we chose to release the information quickly. 

We hope you will find this edition informative. Your comments and suggestions are wel- 
come via the "Reader Comment Sheet" at the back of this manual. 
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26I SCST (SYSTEM CLOCK STATUS)** 1 22 



27 1 SCLC (SYSTEtl CLOCK LAST CDUNT)* 
30-37I 



1 23 

124-31 



NOTE: Ail pointers are absolute addresses. 

LEGEND: ** Needed by Firtiuare and/or by Systeti, aluays 
* Needed during INITIAL 

t Needed by nPE, set up by INITIAL or PROGENITOR. 
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Ilertory Layout 



neMory Layout 



Systeii Global Area 



Systen Global Area (Cont.) 



OCTAL 1 2 3 4 5 6 7 



111111 
9 0 1 2 3 4 5 



SUAPTAB BASE 



100 BASE 
SBUF BASE 



LPDT BASE 



1100 
-I 
IBUF 



lies 

-I 
| LPDT 



111 



SnON BASE 
TRL BASE 
JCUT BASE 



IsnoN 
-I 

j TRL 



I SIR 



141 

I- 
151 



161 

I- 
171 



SIR BASE 



-I 

ISDCTBB 



JPCNT 



DISC REQUEST BASE 



201 



FIRST FREE MEMORY ADDRESS 



22 
23 
241 



TIRE OF LAST CYCLE 



RESERVED 



Break Point Flag 



VDSnTAB BASE 



STATIC FENCE 
CURRENT CST BLOCK INDEX 
(1EASI0 BASE 



-I 



ICSTBX 
— I 

InEASIO 

1 

DISPLACEMENT TO CODE =*?CST(0)-«0ST(0) |DFC 

1 

DISPLACEMENT TO SHARBBLE = 9CST(LAST)-«DST(0) I0FS 
1 

Snon Index I 
1 

BBS ADDRESS (SYSDIT(S)) IDITS 
1 

Reserved ISBAHK 

1 

ABS ADR OF PMBC TABLE FOB LST/STT CHECKING ISBBSE 
1 

RESERVED FOR INITIAL (VDSENTRY) I 
— I 



RESERVED FOR INITIAL (VDSMBP) 
SRTTAB BASE 
SPECQ HEAD 
NuHber of Available Regions 



-I 

ISRTTRB 
-I 

ISPECQHEAD 
-I 

IHOLECOUNT 



# PAGES IN LARGEST CURRENTLY AVAILABLE REGIONIHBXHVAILREG 
- I 

TAKE OVERLAY CANDIDATE INFORMATION IMOCINFO 

1 

NUMBER OF MEMORY BANKS CONFIGURED -1 INBANKS 



SCHEDULER TO AUAKE MESSAGE 
POINTER TO CST8LK TABLE 
AUAKE TO SCHEDULER MESSAGE 
UAIT TO SCHEDULER MESSAGE 
CURRENT ACTIVITY'S PRIORITY 



ISCHEDTOAUAKEMSG 
-I 

ICSTXBLCKPOINTER 

IAUAKETOSCHEDMSG 

-I 
I 

-I 



G.00.00 



G.00.00 



Memory Layout 



System Global Brta (Cont. 1 



I TAIL 



RESERVED 1 64 
FOR I/O < 
SVSTEfl |65 

I 

166 
I 

167 

I 

|70 
i 

171 
I 

1 72 
I 

l?3| 
I I 
\74| 
I 

/ 7S| 
I I 
I 76I 
I I 
I 77 1 
I I 

RESERVED 1 100 1 
FOR FILE< | 
SVSTEn |101| 
I I 



/55| BUSY TR6LE POINTER I6USV 

I I - I 

|56| HERD TABLE POINTER I HEAD 

I I 

I57| TAIL TABLE POINTER 

I I - 

1601 * OF SIO PROGRRtlS EXECUTING ISIOCOUNT 

I I - - | 

161 | PARITY ERROR FLAG (MEN PE) IPBRITY 

I I I 

1621 Impeded queue head for message buffer (PIN) IMtlSGPIN 



I/O Message system error flags llOLOGQX 
(0:1) - No SYSBUF avail for I/O error logging | 
(1:1) - No SYSBUF for IOMESSAGE (GENMSG) | 

- — I 

i OF TERMINALS READING IRDCOUNT 

I 

« OF TERMINALS URITING I URTCQUHT 

- I 

DSET B ICRIO 

I 

ICRIO 

LAST TWER 

ICRIO 



IHSYSORT 
-I 

IPOUERFfllL 
-I 
ISYSUP 



HIGHEST DRT NUMBER 
POUERFAIL 
SYSTEM UP FLAG 
SYS CONSOLE LOGICAL DEVICE NUMBER 
COLD LOW COUNT 
SHARED FCB DST 
MONITORING FLAGS 

MAM It OF SPOOL SECTORS 



ICONSLDEV 
-I 

ICLOAWO 
-I 

ISHFCBOST 



IMBXSSECT 
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System Global Area (Cont.) 



/1 33 1 
I I 
113*1 



SPOOLINOEX 
EXT LABEL FOR SHOUCOM 



RESERVED< 
FOR CS 



11351 

1— 


CS IOUAIT PLR8EL 




11361 

1 1— 


1 CS FIX LEVEL 




11371 
1 1 — 


CS VERSION 




\140| 
I — 


CCLOSE P LABEL 




1411 
i 


LOGICAL PROCESS TABLE (PROGCN) 


0 


142| 

i - 


1431 
1 — 


LOGICAL PROCESS TABLE (UCOP) 


2 


1441 
1 — 


LOGICAL PROCESS TABLE (PFAIL) 


3 


145| 
1— 


LOGICAL PROCESS TABLE (DEVREC) 


4 


1461 

1 — 


LOGICAL PROCESS TABLE (DRUSG) 


5 


1471 
1 — 


LOGICAL PROCESS TA8LE (STMSG) 


6 


1501 
1 — 


LOGICAL PROCESS TABLE (LOG) 


7 


1511 
1 — 


LOGICAL PROCESS TABLE (LOAD) 


8 


1521 
1 — 


LOGICAL PROCESS TABLE (IOMESSPROC) 


9 


1531 
1— 


LOGICAL PROCESS TABLE (SYSIOPRDC) 


10 


1541 
1 — 


LOGICAL PROCESS TABLE MEMLOGP 


11 


1561 


EXTERNAL PLflBEL OF "TERMINATE" 




1561 


INTERNAL P LABEL OF "TERMINATE" 





&.00.00 
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flenory Layout 



Systen Global Area (Cont. 



H02I 
1 1 
|103| 


CURRENT « OF SPOOL KILOSECTORS 


NUMSSECT 


\104| 


• SECTOR/SPOOLFILE EXTENT 


EXTSSECT 


1061 


MAX CODE SEGMENT SIZE 




1061 


I1AX II Of CODE SEGMENTS/PROCESS 




107| 


MAX STACK SIZE (MAXDATA) 




1101 


DEFAULT STACK SIZE 




1111 


MAX EXTRA DATA SEGMENT SIZE 




1121 


MAX N EXTRA DATA SEGMENTS/PROCESS 




1131 


DST number for MESSAGE buffers 




1141 


UPOATE LEVEL 


UPDATE L 


1151 


FIX LEVEL 


FIXL 


1161 
1- 


VERSION LEVEL 


VERSION 


1171 


DEFAULT CPU TIME UNIT 




1201 


It OF SECONDS TO LOGON 




1211 


JOBSYNCH BITS (13:3) 




1221 


EXTERNAL PLflBEL OF INITIATE 




1231 
1- 


INTERNAL PLflBEL OF INITIATE 




124| 
1- 


MBXSYSOST 




1251 
1- 


BRXSYSCST 




1261 
1- 


Ldev for SL.PUB. SYS I HODfl for SL.PUB.SYS 




1271 
1- 


LODfl for SL.PUB.SYS 




1301 

1 


(DIRECTORY) 




131 | 


(DISC ADDRESS) 
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Memory Layout 



Systen Global Area (Cont.) 



I- 



157! 
160 
161 
162 
163 



I- 
1641 



1651 



RESERVED 

FOR 
LOGGING 



EXTERNAL PLA8EL OF "COnTIRNDINTERP" 
INTERNAL P LABEL OF "COHflflNOINTERP" 
EXTERNAL PLABLE OF "SPOOLIN" 
INTERNAL PLABLE OF "TRACEO" 
EXTERNAL PLABEL OF "TRACEO" 
INTERNAL PLABEL OF "SPOOUN" 
EXTERNAL PLflBLE OF "SPOOLOUT" 
INTERNAL PLflBEL OF "SPOOLOUT" 
3 UORD 
LOGGING 
MASK 

DSTN - BUFFER 0 
DSTN - BUFFER 1 
BUFFER LENGTH (SECTORS) 
FREE AREA POINTER 
FLAGX 

8 RECOROS URITTEN IN BUFFER 0 
II RECORDS URITTEN IN BUFFER 1 
FILE SIZE (BLOCKS) - 1ST HALF 
FILE SIZE (BLOCKS) - 2ND HALF 
(LOG FILE SIZE) 
(BLOCKS) 

I 

205| LOG FILE NUMBER (LOGFILENUBJ 

206I NUMBER OF LOGGING [BLOCKS URITTEN (1ST HALF)] j 

207j BLOCKS URITTEN [BLOCKS URITTEN (2ND HALF)] ! 



G.00.00 
i- s 



I 

51 

I 

166| 

167( 

I- 
1701 

I- 
1711 

| 

172 | STATE | 

I- 

173 | STATE | 



1741 

I- 

1751 
I- 

1761 



I- 
1771 



2001 



I- 
2011 

I- 
2021 

I- 
2031 

I- 
204| 
I- 



STATE: 

0 EMPTY 

1 CUR 

2 FULL 



Henory Layout 



Hencry Layout 



Svsten Global Area fCont.) 



2101 (TOTAL * LOG- RECORDS HISSED) 

(DUE TO LOG FAILURE) 



2121 TOTAL* RECORDS HISSED - "JOB INITIATION" LOSS 
! 

213|T0TSL« RECORDS HISSED - "JOB TERMINATION" LOSS 
I- 

2141 OPERATOR CONSOLE JOBSESSION I RT STARTUP 



21S| 
2161 
217| 
I- 



SESERVED FOR KERNEL USE 



2201 HAPPING FIRflURRE FLAG- (NON-ZERO=HPE V/E UCODE) 



221 | BANK BHD ADDRESS OF HAPPING DST ( INITIALIZED 
222 1 BV DISPATCHER DURING LAUNCHING A PROCESS) 

I 

223 | TOTAL SEGHENT NUH8ER OF CURRENT PROCESS 



224 1 



225 1 

I- 
226! 

I- 
227 1 

247 1 

I- 
2S0| 

I- 
251| 

I- 
2521 

I- 
2531 



TOTAL FREE PHYSICAL CST ENTRIES 
HEAD OF FREE PHYSICAL CST LINK 
XLST DST NUT18ER 



RESERVED 



HOLE LIST HEAD (8ANK) 
HOLE LIST HEAD (ADDRESS) 



HOLE LIST TAIL (BANK) 
HOLE LIST TAIL (ADDRESS) 



Svsten Global Area (Cont.) 



SEGMENT 254 
TRACE 
I 
I 
I 
I 



255 

256 

257 

260 

261 

262 

263 

264 

265 

266 

267 

270 

I 271 
I 

I 272 
I 

| 273 

! 

I 274 
KERNEL 
I 275 
I 

I 276 
I 

I 277 



G.00.00 
1- 9 



CURRENT UORD COUNT 
SUFFER SIZE 



HAG TAPE LDEV 
TRACE SEGMENT EXTERNAL LABEL 



STHON 
HEHSINF0TA8PTR 



HEASUREHENT STATISTICS CLBSS HASK 
CLASS 0 STATISTICS BANK NUHBER 
CLASS 0 STATISTICS ADDRESS 



SCAN POINT 
HEASFLflGS 



INDEX OF PCB AT HEAD OF DISPATCHING 0 
INDEX OF PCB AT TAIL OF DISPATCHING 0 



DST It OF CDT TABLE (DISC CACHING) 
BANK * OF THE COT TABLE (DISC CACHING) 



ADDRESS OF CDT TABLE (DISC CACHING) 
HELP LOGICAL DEVICE NUHBER 



CURRENT LOGON DST 



KDSCOUNT 
BUFFSIZE 
LDEV 
TLBBEL 



GCLASSENABLED 

tIEASSTATXDSBRNK 

HEASSTSTXDSBfiSE 



SVSDISOHEAD 
SYSDISPOTAIL 



(STOP) 

(BITS) (see p. 2-15) 



It PROCESS ENTRIES 



G.OO.OO 
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Henory Layout 



nenory Layout 



Systen Global Area (Cont.) 



Svsten Global Area (Cont.) 



PROCESS 

STOP 

TABLE 



304| 
I 

305 
306 
307 1 



X20 
I 



220 
I 

Z20 



I- 



3111 

| 

3121 IOHESS PIN 

I-- 

3131 

| 

3141 NEHLOG PIN 
| 

3151 

| 

3161 

I— - 
317! 

320 1 DS GLOBAL DnTH SEGHENT DST NUHBER 

I - 

321 | RESERVED FOR DS/3000 (SET TO ZERO) 



322 1 

I- 
323 1 

I- 
324 1 



120 
I 

Z20 
RESERVED 
Reserved 



3351 

I- 
3361 

I- 
3371 
I- 
3401 
I- 
11 
I- 
3421 

I- 
3431 
I- 



3411 



3251 



RESERVED FOR DS/3000 (SET TO ZERO) 

SOS LDEV P LABEL 

RESERVED FOR DS/3000 (SET TO ZERO) 

RESERVED FOR DS/30O0 (SET TO ZERO) 

RESERVEO FOR DS/3000 (SET TO ZERO) 



327| 

I- 
3301 



3311 

I- 
3321 



3331 



RESERVED FOR DS/3000 (SET TO ZERO) 
DISC STATUS 
LDEV I DISC 

AONESS 
HAXQUEUE 
DEFAULTQUEUE 



DSCHECK P LABEL 

DSOPEH P LABEL 

DSCLOSE PLABEL 

HANAGEURITE CONV. PLABEL 

CONSOSLINE' PLABEL 

CXREHOTE PLABEL 

CXDSUNE PLABEL 

3441 CXRFR PLABEL 

I " " 

3451 DSIHAGE PLABEL 

I 

3461 DEFAULT LABEL TYPE I TAPE LBL BUTO REC FUN 

I— - 

3471 SYSDB PTR TO TERtl IHIT CHNL PGfl (S30/33 ONLY) 



3501 HP I 
i— : 

3511 
I 

3521 
| 

3531 
I 

354| 

I— - 
3551 



SOFTDERTH FLAG 
HEn PRESSURE 



LAST CYCLE DURATION 



CYCLE THRESHOLD 



3561 

I- 
3571 

I- 
3601 



BUG CATCH ENABLE CELL 
HONITOR BUFFER I 
HONITOR BUFFER I 

DSBRERK PLABEL 



TIPESTRHP 
TIHESTRHP 



LAST 
DISC 
SIO 
ERROR 



361 1 8ank of last nenory word 

I 

362 | Base of last nenory uord 



/363| 

| | 

1 364 1 

PRIVATE< I • 

VOLUHES 1 365 1 VHOUNT FLAGS 
I I 



PVPROC PIN 
PV RECOGNITION COUNT 



jnUTO I ALL| ON 



tlONBUFTO 
H.0NBUFT1 



LAST HEHORY 
ADDRESS 



G.OO.OO 
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nenory Layout 



Systen Global Urea (Corn.) 



13661 
I I- 

13671 

I- 
\370| 



371 1 "SO CATALOG LOEV I 

I 

3721 I1ESSAGE CATALOG DISC ADDRESS 



3731 
374| 



11SG OST 
COHSWLINE' P LABEL 



3751 CONSBRJE P LABEL 

I - - 

3761 SYSTEfl LEVEL UDC FLAG (1 = SYS UOC'S EXIST) 

377 1 



400I 



SYSD6 RELATIVE POINTER TO SYSGLQB EXTENSION 
CPU NUHBER ( Set by the firciuare ) 



402 



MICROCODE flEHORY LOCRTIONS 

*NOTE THAT THE LOCATIONS USED DEPEND ON THE 
TYPE OF CPU THAT fIPE IS RUNNING AND UHETHER 
R OUflP, POUERFAIL, OR CNTL B/HRLT IS PERFORHED 



1401 

02 : 

03 : 

04 ■ 

05 ■ 

06 ■■ 

07 . 



DUHPDEVORT 
X 

DL 

DB - BANK 

DB 

0 

s 



1410 = S - BANK 

11 = Z 

12 = STATUS 

13 = P8 - BANK 

14 = PB 

15 « P 

16 = PL 

17 = CIR 



1420 = NEtlORY SIZE 

21 = SYSTEH HALT » 

22 ■ ISR 



Heno ry Layout 

SysGlob Extension 
1200 uords long; Pointer found at SysOB * 1377 



* 0| 



SWAP OUEUE DELAY (*100HS) 



1| BANK OF FIRST REGION IN LINKED NEtlORY 
I - 

2 1 BASE OF FIRST REGION IN LINKED (1EH0RY 
I 

31 GARBAGE COLLECTION ENABLE FLAG 
I - 

41 HOVE THRESHOLD (IN PAGES, FOR GARB COLL) 

51 

I- 
61 

I- 
71 

I 

101 



IIAIN HEHORY PAGE SIZE (IN UORDS) 
VOS PAGE SIZE 



LAST flAKE ROOH TIKE 



111 HEFIORY PRESSURE DURATION THRESHOLD 

I 

121 RESERVED FOR NATIVE LANGUAGE SUPPORT 



13| RESERVED FOR NATIVE LANGUAGE SUPPORT 

I 

14| BAUD RATE OF THE SYSTEtl CONSOLE 



G.OO.OO 
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Henory Layout 



64! 

I- 
651 

I- 
661 

I- 
671 

I- 
70| 

71 

72 

I- 
73| 

74 1 

I- 
75 1 

I- 
76! 

I- 
77 1 

100I 

I- 
1011 



SysGLofa Entension (Cent. ) 

P LABEL RE CLOG (INTERNAL) 
P LABEL RESTART (EXTERNAL) 
P LABEL RESTART (INTERNAL) 
W»C LOU CORE BANK « (USER) 
PHBC LOU CORE ADDRESS (USER) 
RESERVED FOR IflAGE 
RESERVED FOR I1EASI0 12 | HIOCNT 

LOADER CACHE SEGHENT NUMBER 



15j/////////////////////////////////////////////// 

16| P LABEL FOR REHOTE'flPE 

| 



FIRST 
NEHORY 
REGION 

GARBCOLLENAB 

flOVETHRESH 



SlUIIIIII/lltlilltllllllllllllllllltllllltlllllll 
601 P LABEL USERLOG (EXTERNAL) 



I- 



621 



P LABEL USERLOG (INTERNAL) 
P LABEL RECLOG (EXTERNAL) 



G.OO.OO 
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llenory Layout 



SysGlob Extension (Cont.) 



1221 



1231 
127| 



INITIAL/PROGEN COM. DSEG NUH8ER 



CURRENTLY UNASSIGNED 



P LABEL 3270 (EXTERNAL) 



VERSION 
UPDATE 



FIX 



COUNT OF TAPE CONTROLLERS USING HEASIO 

PORT DATA SE GHENT NUI1BER 

RESERVED FOR SECOND PORT DATA SEGHENT 

I— — — 

1021 SYSTEH FPHBP OPTION FLAG 



1031 
1041 

105| 
1061 
1071 
1101 



GLOBAL 
ALLOU 
HASK 



1111 RESERVED 
1171 

1201 SYS PORT PROCESS PCB RELATIVE INDEX 

I 

12' I GLOBAL BFT DST NUflBES 



1301 (DS.NETUORK HGHT.APPLICATION SERVICES) 
1311 



132 
133 
134 



I — 



1351 

I- 
1361 

I- 
1371 

I- 

140: 

141 
142 
143 
144 
145 

I- 
1461 

I- 
147| 

I- 
1501 

I- 
151| 

I- 

I- 
2001 



RESERVED FOR SPL 
PATH FLOU 
RNALYZER 



CURRENTLY UNASSIGNED 



* MOCNT = HEASIOCOUNT (3 BITS) 
» HEASFIAGS (15:1) = 1 ==> nONITOR ENBBLED 



5.00.X 
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Henory Layout 


nenory Layout 


(14:1) = 1 ==> BUFFER FLIP/FLOP 


JOBSYNCH job synchronization via jobsynch (sysglob+121 (8)) 


(13:1) = 1 ==> EOT ON nONITOR TAPE 




SYSDB Uords 


(13:1) - JOBSRERDY - set by DEVREC & HORGUE (via procedure STRRTDEVICE) 




indicating a ready job. This prevents UCOP fron 


Systen tables nay be accessed by using the LST/SST instructions. Pointers 


going to a uait state uhen a job is just Made 


have the follouing fornat: 


ready. 


0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 


(15:1) - DEVFREED - set by DEALLOCATE uhen device count goes to 0. 


| 1 

j Address I Bank I 




| 1 


HOTE - Both bits above used for synchronization of job-nade- ready or 




devicefreed uhen UCOP is running. 


Rddress is the uhole word with "Bank" nasked out to 00000. 






(14:1) - JOBSUAITING- set by UCOP just before waiting if any job is 


Systens that have rtPE V/E Microcode (all 6X systens, 4X systens uith neu 


uaitmg for list device. Signals DEALLOCATE to 


boards) can have a non-zero bank nunber. Systens running pre-nPE V/E Micro- 


auake UCOP uhen a device is freed. 


code can only use bank 0, therefore the pointer uill look like: 




0 1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 


Allou nask Fornat 


| 1 

I Address 


The Rllou nask for MPE V is expanded to six uords. There is a nask in each 


| | 


user's JIT and in the SYSGLOB area. The Rllou nask contains enough bits for 




a one-to-one correspondence to every present OPERATOR type conMand, or any 


SysGlob Word Definitions 


future OPERATOR connand. Uhen a user is RLLOUed any OPERATOR connand or 


ASSOCIATEd to a device (which uill use OPERATOR type connands) then the cor- 


RDDRESS NfttlE FUNCTION 


responding bit(s) in the nask in that user's JIT for that connand is set. If 




the ALLOU or ASSOCIATE uas done on a global scale, then the bit(s) in the 


DB*55 BUSY - SYSDB relative pointer to BUSY TBBLE for 


nask of the SYSGLOB area is/are updated. 


1/0 resources 




DB+56 HERD - SYSDB relative pointer to table containing 


The follouing EQUATES define the nask bit for each operator connand. 


head pointers to I/O resource queues 




DB+57 TAIL - SYSDB relative pointer to table containing 


The first set of connands define the operator connands dealing uith devices. 


head pointers to tail of I/O resource queues 




DB+60 SIO COUNT - Nunber of I/O Prograns currently executing 


Uhen adding a neu connand to this set of EQUATES, be sure to add a cor- 


DB+72 POUER FAIL - 0-no power fail 


responding nove statenent in LOGItlRGE, even if the connand uill not be 


1-systen disc recovery 


logged. 


2-all other disc recovery 




3-all other device recovery 


Uord Bit | 


08*73 SYSUP - Systen is up and operable 




DB+74 CONSLDEVN - Systen console logical device nunber 


ABORTIO 0 0 0 


DB+400 CPU NUH8ER - Set uhen systen aborts 


ACCEPT 0 1 1 


DOUN 0 2 2 




GIVE 0 3 3 




HEADOFF 0 4 4 




HEROON 0 5 5 




REFUSE 0 6 6 




REPLY 0 7 7 




STRRTSPOOL 0 8 8 




TAKE 0 9 9 




UP 0 10 10 




HP LINE 0 11 11 




OSCONTROL 0 12 12 


5.00.00 


G.00.00 
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Henory Layout 


Henory Layout 


UPPER LIMT->DEVICE COffllANDS 


Rllou nask (Cont.) 


RBORTJOB 0 13 13 


Uord Bit # 


ALLOU 0 14 14 




ALTFILE 0 15 15 


URRN 1 14 30 


RLTJOB 1 0 16 


UELCOnE 1 15 31 


BREAKJOB 1 1 17 


HON 2 0 32 


DELETE 1 2 18 


DOFF 2 1 33 


DISALLOU 1 3 19 


VnOUNT 2 2 34 


JOBFENCE 1 4 20 


UIOUNT 2 3 35 


LIBIT 1 6 21 


LDISnOUNT 2 4 36 


STOPSPOOL 1 6 22 


BRJECONTROl 2 5 37 


SUSPENDSPOOL 1 7 23 


JOBSECURITY 2 6 38 


OUTFENCE 1 8 24 


DOUNLORO 2 7 39 


RECALL 1 9 25 


niOENABLE 2 8 40 


RESUHEJOB 1 10 26 


niODISRSLE 2 9 41 


RESUnESPOOL 1 11 27 


LOG 2 10 42 


STRERfIS 1 12 28 


FOREIGN 2 11 43 


CONSOLE 1 13 29 


MF 2 12 44 




SHOUCOH 2 13 45 




OPENQ 2 14 46 




SHUTQ 2 15 47 




DISCRPS 3 2 48 




Loqqinq Related Locations 




SYSDB 




0 1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 




172 l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l 




or | STATE ) DST » I 




,73 | 1 




STRTE = 0 if respective buffer enpty 




1 if respective buffer is current 




2 if respective buffer is full 




FLRGK 




SYSOB 




0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 




|- |-|-|-|..|..|.-|..|-|— l-l-l-l — | — |— | 

1 76 | //////////////////////////////// 1 SF | HFIBUF | SLISD | 
| _ | 




SF = 1 if soft failure 




HF = 1 if hard failure 




BUF = 0 if current log buffer is buffer 0 




= 1 if current log buffer is buffer 1 




SL = 1 to indicate a switch in log buffers (fron 0 to 1 or fron 1 to 0) 




SO = 1 to indicate shutdown in progress 


0.00.00 


G.00.00 
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nenory Layout 



Renory Layout 



Process Stop List General Layout 



STOP BITS REPRESENT IHD UHICH 
PROCESSES TO STOP ON "SHUTOOUN" 



ft PROCESS ENTRIES 



-I 



/////////////////////////////////////////////// 
1ST PROCESS ENTRY 
2ND PROCESS ENTRY 



LAST PROCESS ENTRY 



Entry Fomat 

0 T 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



-| H __|-,j„ M __,__|„|„| HH __|__,„|_ 



PROCESS PIN ft 



I 



STOP BIT ft 



PROCESS UAIT STATE 



Preassigned Entries 

entry ft process 



devrec 

ucop 

log 



stop bit ft 



0.00.00 
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Initial nenory Allocation 



This section is a description of the Method used by INITIAL to allocate 
nenory for RP£ tables and code segnents in WE V/E. All nenory allocated by 
INITIAL is pernanently allocated. All non-core resident code and data is put 
on disc before exiting INITIAL. 

At the riost basic level INITIAL Mill try to build nenory to look exactly as 
diagranned below. There are, however, several nays in which to deviate fron 
this structure. Sefore going into the sources of these deviations, it is 
necessary to point out which portions of nenory are used by INITIAL during 
the restart and therefore cannot be used by flPE until INITIAL has finished. 

Before INITIAL begins to allocate any nenory space, it relocates its core 
resident code, its code segnent swapping area and its stack to the highest 
configured nenory space. Additionally, it uses the last Z326 words of bank 0 
on series 4x Machines for its I/O buffer area and tenporary code segnent 
table. After INITIAL has built all of core resident UPE (tables and code), it 
builds the disc resident HPE tables. Since sone of the disc resident tables 
nay be too large to be built in INITIAL'S stack, these tables are built in 
unused nenory space. Therefore, in addition to the nenory space required for 
INITIAL'S code, INITIAL'S stack and core resident HPE, there nust be enough 
space left in which to build the largest of the disc resident tables. 

For Series 6x nachines uith the HPS V/E firmiare, INITIAL uill build the 
tables with ">" signs by then out of Bank 0 if necessary. For ail other 
tables, INITIAL Mill essentially build nenory in the order shoun below, 
There nay be an unused fragnent of nenory betueen the DRT's and the systen 
global area which INITIAL uill fill uith the snaller tables. Neither the 
tables narked uith an asterisk nor the code segnents uill ever be put in this 
area. NOTE: INITIAL uill build all tables on 32-word boundaries. 

If the systen being built by INITIAL is configured uith 128K uords or 160K 
Herds of nenory then INITIAL'S stack will be in bank 1 (the code also on a 
12SK word nenory size). If INITIAL is occupying part of bank 1 and the space 
is needed for a core resident OPE code segnent or to build a disc resident 
table then INITIAL uill print the error nessage "ERROR 11350 OUT OF tIEIWRY". 

Except for the exceptions stated above, for every allocation of nenory 
INITIAL uill first try to allocate any renaining space between the DRT's and 
SYSDB. It uill then try the next available space in bank 0, then the next 
available space in bank 1. If it were necessary it could continue searching 
until all all banks were checked for available space. 

Innediately before exiting INITIAL, INITIAL lays down all the nenory region 
headers and trailers as shoun belou. For any one bank of nenory there uill 
only be one block of core resident HPE, regardless of its contents. The only 
block of core resident HPE that does not have a reserved region global header 
is in bank 0. It does have the reserved region global trailer though. Before 
placing any code outside bank 0 the first 24 uords of every bank (except bank 
0) is reserved for the region global header. 
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Bank 0 



Lou Core nenory 



>0RT 

Systen Global area 
Firtinare area 
SYSGLOB Extension 
OST/CST/CSTX 
ICS 



pubc 



ILT/DIT 



DLT 



Resource Tables 

CST Block 
>flenory Fleasurenent Info 

VDSn Table 
Job Process Count 
> PRI/SEC HSR 
>PCB 

> Suap Table (SLL) 
>Special Request Table 
>Job Cutoff Table 
>Tiner Request List 
>Syste« Buffers 
>LP0T 
>I0Q 
>SIR 
>H0N Table 
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tlenory Layout 



(Only on 64/68 if Pri- 
vilege node Bounds 
Checking is enabled.) 



nenory Layout 



Bank 0 (Cont.) 



I ■ 

I 

I Core Resident CST's in CST order 



(Only for 64/68 if Pri- 
vilege node Bounds 
Checking is enabled.) 



Reserved Region Global Trailer 
Available Region Global Header 



Available flenory 



Available Region Global Trailer 
NOTE: The > neans these tables can nove out of Bank 0 if necessary. 



Bank 1 



I 



"I 



I Reserved Region Global Header j 



Core Resident CST's and 
tables narked uith ">" that 
didn't fit in BANK 0 



I Reserved Region Global Trailer | 



I- 



-; 
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CHAPTER 1 ftEflORV nfiHRGEIIEWT TABLES 



Segnent Table Structure 



The current location and state of each data segnent and loaded code segnent 
is Maintained in the Segnent Table. This table is partitioned into three 
separate tables as shown in Figure 2-1. The partitions are based on the seg- 
nent classes: a segnent is a data segnent, a segnent is a systen SL segnent, 
or a segnent is part of a progran. The structure and fornat of each parti- 
tion is described in the following. 



(ZO),(Z1001)+SYS8HSE 



(Z1051) --> 



csTxnfip *~ 
- I 



■ — + + y 



First 
LOADED 
PROGRAfl 

»<-. ( Z 3), CURRENT PROGRAH POINTER 

NEXT [ 
LOADED 
PROGRfln 



nenory nanagenent 

Pointers and DST O's of Segnent Table Conponents 
i. DST 

X 2 absolute address of entry 0 of the DST. 21002 sysbase rela- 
tive index of entry 0 of DST. DST nunber 2 is the DST Table dst 
». 



2 0 absolute address of entry 0 of Systen SL. 21001 sysbase 
relative index of entry 0 of Systen SL. 21032 displacenent fron 
DST base of entry 0 of Systen SL (i.e. SCST(last) - SDSTtO) - 
DPS ). DST nunber 4 is the CSTX Table DST *. 



2 1 absolute address of entry 0 of current progran. 21033 dis- 
placenent fron DST base to first CSTX entry SL. DST nunber 4 is 
the CSTX Table DST ». 



21051 sysbase relative index of entry 0 of CSTXflHP. DST nunber 
43 (272) is CSTXhBP Table DST ». 



Overall ST Structure 
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Standard Object Identifier Fornat 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



DST General Entry Fornat 
Case (i) DST Entry for a Present Oata Segnent 



T¥PE | 



CST8LK 
OBJECT NUnFJER 



OBJIDENTIFIER(0).(0:4) ==> TYPE 

= 0 Object is a Data segnent 

- 1 Object is an SL segnent 

= 2 Object is a Progran segnent 

= 3 Object is a Cache Donain 

0BJIDENTIFIER(O).(4:12) «> Progran index into CSTXBLK 
0BJIDENTIFIER(1).(0:16) «> Nunber field: 

DST, CST, CSTX, or CDT nunber 



DST Entry Fomats 
DST/CST Entry 0 Fomat 



UORD 0 
UORD 1 



UORD 2 
UORD 3 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

|-|-_|-_|__ MH __|-_ MH ...| HH __|__; 



A |0 |R I 



SIZE/4 



D |R 
C |0 
V |c 

I 



i is in if is ic l u | 

n it |o lu |v io l o | 

I IK ID II IS IE I I 

I I IP I IE I I 



BANK 



nnBANK 
nnBBSE 



Case (ii) DST Entry for an Hbsent Data Segnent 



S 9 ! 



13 14 ' 



UORD 0 
UORD 1 
UORD 2 
UORD 3 



-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l- 



t* CONFIGURED ENTRIES 
ENTRY LENGTH (4) 



» AVAILABLE ENTRIES 

TABLE RELATIVE INDEX TO FIRST FREE ENTRY 



UORD 0 
UORD 1 



UORD 2 
UORD 3 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l- 
A |0 |R | SIZE/4 | FIRMNFO 



D |R |I IS |n IF |S |C |U| 

C IO in |T |0 |U |Y |0 ID | 

V |C II |K ID II IS |R | | 

I I I I IP I IE I I 



LOEV 8 



I 



HQDA 
LOOP 
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CST Entry Fornats 

CST General Entry Fornat 

Case (i) CST Entry for a Present SI Segnent or CSTX Segnent 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|..|..|..|..|„|..|..|..|..|..|..|..|..|..|..j..j 

uord o in in is it i size/4 | fmiinfo 

I — I 

UORO 1 I/ |R II I/ 1/ 1/ IS IC I I 

1/ 10 in 1/ 1/ I /It 10 I////////////////////// I FLAGS 
1/ IC II 1/ 1/ 1/ IS IR I////////////////////// I 
1/111/ 1/ 1/ I IE I////////////////////// | 
| 1 

uoro 2 | sank | nneflHK 

I I 

UORO 3 | BASE | MISUSE 

I - I 



CASE (ii) CST Entry For An absent Segnent SI or CSTX Segnent 



UORO 0 
UORO 1 



UORO 2 
UORO 3 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 IS 

IR in IB IT | SIZE/4 I FIRMINFO 

I I 

1/ IR II 1/ 1/ 1/ IS IC I ///////////////////// I 

1/ lo m 1/ 1/ i i\i io I////////////////////// I Fines 

1/ IC II 1/ 1/ 1/ IS |R I////////////////////// I 
1/ I I 1/ 1/ 1/ I IE I////////////////////// I 



L0EV It 



I 



won 



I Hoon 
-I 

I LOOR 



Case (ill) OST/CST Free Entry 



Z100000 



TABLE RELATIVE OFFSET TO NEXT FREE ENTRY 
TABLE RELATIVE OFFSET TO PREVIOUS FREE ENTRY 
jllllllllllllljllltlttlillllltltllltlllllltll 



Refer to the Logical Segnent Table Fornat in Chapter 11 for nore 
infomation on XCST. 
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ST Entry Field Descriptions 

R - 1 -} segnent absent 

n = 1 ==> segnent privileged 

R = 1 ==> segnent has been referenced 

T = 1 ==> segnent is being traced 
OCV = 1 ==> disc copy is valid 
STK = 1 ==> segnent is a stack 

noo = 1 ==) a segnent nodification (exp., contr. ) is pending 
FUIP= 1 --> a forced urite of this segnent is in progress 
VtlPRGECNT = It of virtual nenory pages allocated to this segnent 
ROC = 1 ==> segnent is recoverable overlay candidate 
Inl - 1 ==> segnent is in notion in 
SYS - 1 "> segnent is a systen segnent 
C0RE= 1 "> segnent is care resident 
110= 1 «> urite disabled 



CSTBLK Fornat 
CSTBLK(O) 



* NUNBER OF ENTRIES IN TABLE 



1 

* ANY UNASSIGNED ENTRY - -1 



* ANY ASSIGNED ENTRY > 0 



* RENAMING CSTBLK TABLE ENTRIES 



The table is initialized to ninus one in each entry, linen selected, the 
entry is replaced by a DST-relative index to the entry ItO of the CST exten- 
sion block. This is the the overhead entry For the associated program 
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Nenory llanagenent 

Proaran Blocks and the CSTHMHP 

Since prograns can be dynanically loaded and unloaded, the segnent table nust 
be kept packed or f ragnentation uouid occur. Thus, the block of ST entries 
for a progran segnent begins at an ST entry nunber that changes if a progran 
which Has loaded before it gets unloaded. To nanage this dynanic structure, 
an auxiliary structure, the CSTXhW is used. A progran is identified by its 
index, CSTXEIX, into this nap. The progran's current beginning physical ST 
entry nunber is equal to equal to CSTnflP (CSTXEIX). 

Entry Fornat - CST Extension Block 

csTxnnp(csTXEix)-) 

0 * n = tt OF CST'S IN BLOCK « 

1 * VAUDITY=I125252 * 

2 * H OF USERS SHARING BLOCK * 

3 « 0 * 

XCST NON-XCST 

1 - > * HAS CST ENTRY FORhUT * <- — 1301 

2 > * HAS CST ENTRY FORBAT * <- — 2302 

tn > « HAS CST ENTRY FORMAT « < — X303 



The value of CSTXEIX is established uhen a CST extension block is allocated. 
This index into the array CSTXBRP is Maintained in the PCB of each process 
sharing the block. 



Nenory llanagenent 



OCTAL 
0 
1 
2 
3 
4 
5 
6 
7 
10 
11 
12 



CST 
OST 
PCB 
CSTX 

SYSTEN GLOBAL AREA 



CORE 
ICS 



SYSTEN BUFFERS 
UCOP REQUEST OUEUE 



PROCESS-PROCESS 
COfMINICATION TABLE 



Fixed DST Entry Rssionnents 

DEClnfiL TABLE NRI 

0 
1 
2 
3 
4 
5 
6 
7 
8 
9 
10 



I/O QUEUE 



TERNINAL BUFFERS 



LOGICAL-PHYSICAL 
DEVICE TABLE 



LOGICAL DEVICE 
TABLE 



DRIVER LINKAGE TABLE 
I/O RESOURCE TABLES 
SECONDARY NSG TABLE 
LOADER SEGNENT TABLE 
TIMER REQUEST LIST 
DIRECTORY 



CST 
OST 
PCB 
CSTX 
SYS 
CORE 
ICS 
SBUF 
UCRQ 

PPCON 

IOQ 

TBUF 

LPDT 

LOT 
DLT 

BUSY, HERD, TAIL 

SECMSGTA8 

LST 

TRL 

DOS 
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Nenory nanagenent 



DST (Cont.) 
OCTAL 



OIRECTORY SPACE 
BIN TABLE 

SUAPTABLE (SLL) 
JOB PROCESS COUNT 
JOB RASTER TABLE 



TAPE LABEL 
TABLE 



REPLY INFORMATION 
TABLE 



VOLUME TABLE 
BREAKPOINT TABLE 
LOG BUFFER1 
LOG BUFFER2 

LOG ID TABLE 
ASSOCIATE TABLE 
CST BLOCK 
JOB CUTOFF TABLE 
SYSTEM JIT 
SPECIAL REO TABLE 



VIRTUAL DISC SPACE 
MANAGEMENT TABLE 



DEVICE CLASS TABLE 
Reserved Kernel 



DECIMAL 
21 
22 
23 
24 
25 
26 

27 
28 

29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 

40 
41 



RIM 

SUAPTAB 

JPCNT 

JtlRT 

VDD 
LOGTAB 

RIT 

VTAB 

STOP 



CSTBLK 
JCOT 
SJIT 
SRT 

VDSMTAB 
DEVCLASS 
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denary Management 

DST (Cont.) 
OCTAL 



DECIMAL 



52 


I ILT ! 


42 


53 


I SIR TABLE i 


43 


54 


| FMAVT I 


44 


55 


I INPUT DEVICE DIRECT I 


45 


56 


I OUTPUT DEVICE DIRECT I 


46 


57 


I UELC0I1E MESSAGE «1 i 


47 


60 


I UELCOME MESSAGE 02 I 


48 


61 


I CS DATA SEGMENT I 


49 


62 


I PROCESS-JOB I 
I CROSS REFERENCE I 


50 


63 


I SYSTEM JOT I 


51 


64 


I COMMAND LOGON DST I 


52 


65 


I MOUNTED VOL. SET TABLE! 


S3 


66 


I PRI.VOL. USER TABLE I 


54 


67 


I RESERVED KERNEL I 


55 


70 


I DISC REQUEST TABLE I 


56 


71 


I MSG HARBOR TABLE I 


57 


72 


| PRIMARY MESSAGE TABLE I 


58 


73 


I MEASUREMENT INFO TABLE I 


59 


74 


I FIRST FREE DST I 


60 



TABLE NAME 

ILT 

SIR 

FMAVT 

IDD 

ODD 

L0G0NDSTN1 
L0G0NDSTN2 
CSTAB 
PJKREF 

SYSJDT 
CILOGDST 
MVTA8 
PVUSER 

OISCREOTAB 
MSGHARBTHB 
PRIMMSGTAB 
MEBSINFOTAB 
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Memory Managenent 



Snap Tables 



Henory Managenent 

SUAPTAB Unassiqned Entry Fornat 



The SUAPTAB is a core resident nenory nanagenent table used to keep track of 
the locality lists of the competing processes. The PCB entry for a process 
has a SUAPTAB relative pointer to the header entry for the process. 

SNAPTM DST* = 23 (X27) 

11004 Systen table pointer to SUAPTAB entry 0. 

NOTE: The nunber of entries configured will be 3 
greater than the nunber configured via 
SYSDUMP. (Entry 0 consunes 3 entries). 

SUAPTAB Entry 0 Fornat 



0 1 2 3 4 5 6 7 ! 9 10 11 12 13 14 15 
_ M ..|~|~|-|~|~|~|~|~|-|~|~|-|~ 
» ENTRIES CONFIGURED 

ENTRY SIZE (6) 

* AVAILABLE ENTRIES 

TABLE RELATIVE INDEX OF FIRST FREE ENTRY 

TABLE RELATIVE INDEX OF LAST FREE ENTRY 



HIGH UATER MARK 
B PRIMARY ENTRIES (0) 
HEAD OF IMPEDED OUEUE (PCB RELATIVE) 
TAIL OF IMPEDED QUEUE (PCB RELATIVE) 
• CURRENTLY IMPEDED PROCESSES 
MAX » OF IMPEDED PROCESSES 
CUMULATIVE # OF IMPEDED PROCESSES 



0 
1 
2 
3 
4 
5 
6 

7 

10 
11 
12 
13 
14 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
2100000 



TABLE RELATIVE INDEX OF NEXT FREE ENTRY 
TABLE RELATIVE INDEX OF PREV. FREE ENTRY 

0 

0 

0 



An assigned entry in the swaptab is a process' SLL header or a itenber of a 
process' SLL. These fornats are now described. 
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Menory Management 



Sequent Locality Lists (SLL) 

The systen maintains for each proceas a segnent locality list (SLL) of the 
segnents belonging to that process' current working set. The process' SLL 
consists of a header and a list of entries. The header and list entries are 
taken frai the SUAPTRB. 

A process' SLL is located via the process' PCB entry. PC8D1 contains the SLL 
relative index of the process' SLL header. 



FIRST SLL ENTRY 



NEXT SLL ENTRY 
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nenory hanagenent 
SLL Header fomat 



0 12 3 4 5 6 

IS |H |I |P |S IS I 

|U |S IN |R IT |U | 

|R IS |T |R |R |I | 

IE IB |l |T |T |P | 

ID IE ID IX | 0 | | 

I in ic in |v | | 



8 9 10 11 12 13 14 15 
-I-I-I-I--I--I-I-- 



TABLE RELATIVE INDEX OF FIRST ENTRY IN LIST 
/////////////////////////////////////////////// 
TRBLE RELATIVE INDEX OF MEMORY REQUEST ENTRY 
» ENTRIES IN PROCESS' SLL 

iiiiiiimiiiiiiimmmtiiiiuiiiiiiiiunii 



SCHEDTOIOnSG 



MEMREQINX 
SEGCOUNT 



SLLCSLLHEADINX+O) 

.(1:1) SUREQ, Suap Required Flag 

.(2:1) HHSHEn, Has nenory Flag 

.(3:1) INTLOC, Initialize locality to nininun 

.(4:1) PRRTIH, Process partially suapped in 

.(5:1) STRTOV, Start suap over flag 

.(6:1) SHIP, Snap In Progress flag 

.(8:8) IOCNT, Segnent read completions until auake 
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SLL List Entry Fomat 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
-|-|-|~|~l~l-|"l~l~l~l~|-l-|-|" 
PCB RELATIVE INDEX OF THE NEXT MPEOED PIN 



TABLE RELATIVE INDEX TO NEXT ENTRY IN LIST 
TABLE RELATIVE INDEX TO PREV. ENTRY IN LIST 



OBJECT IDENTIFIER 



n 


S ID |L IB |F |S IT 


IF 


IL ID 




A 


T |I |0 IL |R IL |0 


IZ 


IK IE 


PRE 


p 


K IS IC |K |0 |L IS 


|R 


IK IC 


FETCH 


s 


IC IK |R |Z |I IS 


IE 


IE |C 


COUNT 


E 


II IE IE IE in | 


ID 


10 IN 




6 


10 ID |Q IN II | 


I 


I IT 





henory Management 



NEXTIhPPIN 

NEXTINX 

PREVINX 

SLL'OUDESC 

SLL'OBJNUB 

SLL'FLRGS 



flenory tlanagenent 
Special Request Table 



Used for passing data segnent size change info and for keeping 
a list of devices waiting for a segnent to arrive in nenory. 

11042 - SRT relative index to entry N 0 

11043 - SRT relative index to the head of the queue 

NOTE: The nunber of entries configured uill be 3 greater 
than the nunber configured via SYSOUMP. (Entry SC 
consunes 3 entries). 



SRT Entry 0 Fomat 



SLL(SLUNXtO) NEXTWPPIN, next nake present deferred queue 
PCB Index 

SLL(SLUNX*1) NEXTINX, next SLL entry 

SLL(SLUNXtZ) PREVINX, previous SLL entry 

SLL(SLLINX*3) SLL'OBJDESC, 1st uord of object identifier 

SLL(SLUNXt4) SLl'OBJNUM, 2nd uord of object identifier 

SLL(SLUNX*5) 

.(0:1) NAPSEG, process' CST napping segnent (LSTT) 

.(1:1) STK, process' stack entry 

.(2:1) DISCIOSEG, disc I/O pending on this segnent 

.(3:1) LOCKED, segnent locked in nenory 

.(4:1) BLKLK, request for blocked lock 

.(5:1) FROZE, segnent frozen in nenory 

.(6:1) SLLIfll, process queued for this segnent 

.(7:1) TOSS, Toss this entry 

.(8:1) FRZAEQ, request segnent to be frozen 

.(9:1) LKREQ, request to lock segnent in nenory 

.(10:1) DECCNTFLRG, 

.(11:5) PREf ETCHCOUhT, 



Thp Suflo Table will tie ccnfigi/red uitK 
nunber of configured PCBs. 



» ENTRIES CONFIGURED 
ENTRY SIZE (6) 



N AVAILABLE ENTRIES 



TABLE REL. INDEX OF 1ST FREE ENTRY 
TABLE REL. INDEX OF LAST FREE ENTRY 
HIGH UBTER HARK 
* PRIMARY ENTRIES 



HERD OF IMPEDED QUEUE (PCB REL.) 
TAIL OF IMPEDED QUEUE (PCB REL.) 

• CURRENTLY IMPEDED PROCESSES 

• HAXinUM IMPEDED PROCESSES 
CUnULATIVE « OF IMPEDED PROCESSES 
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The following entry fornat i» for data segnent size changes: 

I i 

0 I NEXT ENTRY FOR DATA SEGMENTS I 
I " I 

1 I I 
I- OBJECT IDENTIFIES -| 

2 I I 
I 1 

3 I NEU DfiTB SEGMENT SIZE I 
I " I 

4 | REND DISPLACEMENT I 
I 1 

5 | nOVE COUNT | 
I 1 

The following is the fornat for devices waiting on a segnent: (The region 
header for the segnent contains an SRT relative index to this entry. If More 
that 5 devices are waiting on this segnent, another entry will be linked to 
this entry. ) 



NEXT ENTRY OF QUEUED DEVS ON SEG 



3 

4 I 
I- 

5 I 



IOQINX 
IOQINX 



The nunber of prinary configured entries will be equal 
to the total nunber of LDEVs configured. The nunber of 
secondary entries Hill be configured to be at least the 
sane as the nunber of PC8s configured. Data segnent change 
entries are secondary type, while devices queued entries 
will be prinary entries. 
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Rain Henory Region Headers and Trailers 



Rain Henory is partitioned into regions. Each region is in one of three 
states: available, reserved, or assigned. 

An available region is available for consunption by the free space allocation 
nechanisn. fln available region consists of neighboring subregions, each of 
which is either a hole or an overlay candidate. An available region is 
linked into the available region list. 

R reserved region is a nain nenory region which is in the transition state 
fron available to assigned. A reserved region has been cleaned, and there is 
a pending disc read of a segnent into the region. 

Assigned regions are occupied by present segnents. Available and reserved 
regions consist of one or nore adjacent subregions. Region headers and 
trailers are partitioned into global and local conponents. The global region 
header/trailer is only valid for the first/last subregion in regions consist- 
ing of nore than one subregion. 

The region headers and trailers of available, reserved, and assigned regions 
contain the state and control information pertaining to the current or plan- 
ned contents of the region. 

Cache donains are another fom of assigned regions and are designated as such 
in the subregion header. IF the cache donain is "napped" - has I/O pending 
against it - then the object identifier will have a non-zero value in the 
second word of the segnent identifier field. If the second word of the seg- 
nent identifier field is zero, then this region is a cache donain that is un- 
napped. (Refer to Chapter 23 for further infornation regarding Oisc 
Caching.) 
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Header length = 24 
Trailer length = 4 

global Region Trailer 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

RB-27 | PREVIOUS TRAILER SUBREGION SIZE 
| 

R6-26 



I PTSS 

1 

I PREVIOUS TRAILER REGION STATE I PTRRS 

in ir ir uimiiiiiiiiimiiiiiimiiiiiuiitis 
is ie iv i iiiimiimiiiiiiiiiiiiiimiiiiiiii i 
is is i i iiiiiiiiiiimiiiiiiiiiiiiiiiiiim/i i 
i — - — i 

RB-25 I PREVIOUS TRRILER REGION SIZE I PTRS 



Global Region Header (Available Regions) 



0 1 2 3 4 5 6 '7 8 9 10 11 12 13 14 15 



Henory Itanagenent 

Subregion Header (Available Regions) 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 1415 
RB-15 | SUBREGION ASSIGNMENT STATE I SBS 

ic ir ir i iiiiiiuiiiniiiimimmn 1 1 i 

|A IE 10 I IIIIHIIIIIIIIIHIIIIIIIIIill 1 0 j 

ic if ic i iimiiiiiiimiiiiiiiiiiiiti i s i 
ih i i i imiiimiiiiiiiiiiiiiiiiiii i t i 
, 1 

1 SUBREGION SIZE j SS 



RB-14 

RB-13 iV | SUBREGION DISPLACEMENT IN I1RIN BEn. PAGES \ SO 
RB-12 
RB-11 



URITE RF.0UEST POINTER 



I UREOP 



-I 



OBJECT IDENTIFIER 



RB-24 I REGION ASSIGNMENT STATE I RBS 

|A |R |n IC IS |L |F II I///////////////////IB I 

IS IE IV |L IC IK |Z 10 I///////////////////II I 

IS IS | IN | IP IN |F I///////////////////IP I 

I I I ID I | | IZ \litlll!li!lllllllll\ I 

I I I I I I I IN I IIIIIHIIII11IIIIII I I 

| 1 

RB-23 | REGION SIZE I RS 

I 1 

rb-22 uHiiiiiiimimtimiiiiiiii/iimiiiiiiiim 

rb-21 umiimiiiiiiiimmmiiiiiiiiiiiimiiim 
i i 

RB-20 | PREVIOUS LINK (ADDRESS OF PL FIELD I PL 

I- -I 
i OF PREVIOUS RVRILRBLE REGION) | 
| 1 

RB-18 | NEXT LINK (RDCRESS OF NL FIELD I HI 

I- -I 
I IN NEXT AVAILABLE REGION) | 
| 1 

RB-16 MlllllllllllllllltllllllimillllllllllUllim 



uiiiiiimiitiiiiiiitiiiiiHiiiiuiiiiiiiiiim 

i i 

iiiiiiiiiiimiiiiiiiiiiiiiiiiiiiiiiiiiniiiin 



I OBJIOENT 



RB-7 
RB-6 
RB-B 
RB-4 
RB-3 
RB-2 
RB-1 



HODR 



Lou Order Disk Address 



I HODR 
-I 
I LODA 



i iimiiiiimiiiiiimuimumiiiiiiiiiim i 

i i 

i iiiiiiiimiiiiiiiimiii/iiiiiiimiiimiiii i 

i 1 

i iiumiiiiiiniiiimmiiiiiimiiiiiitiiiii i 

i — - i 

i iiiiiiiiiuiiiiiiiuiiiiiiiiimiiiiiiiiiiim i 

i — i 

i immmmiiiiiiiimmiiiiiiiimiiiiiiii i 



flenory flanagenent 



Global Region Header (Reserved Regions) 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



RB-23 
RB-22 



RB-18 
RB-17 



REGION ASSI&HflEhT STATE 
R |R Ifl IC IS IL IF II | IIIIIIIIIIIIIIIIIII I n 
S |E |V IL IC IK |Z |0 | IIIIIIIIIIIIIIIIIII 1 1 
S IS | |N | |P |H |F | IIIIIIIIIIIIIIIIIII IP 
I I ID I I I |Z \lllllllllllllllllll\ 
I I I I I I IN Mllllllllllllllllll\ 



REGION SIZE 



OH GOING I/O COUNT 



INITIATION BESSAGE 

n IE 10 10 II IE |G in |R in | lllllllllllll I n 

S |X |N |U IN 111 ID |S IE IS I lllllllllllll IS 

G |T |G IE |C IP |R |G IL |G I lllllllllllll I G 

P 10 10 IS 10 |R IB |A IP IS I/////////////IV 

R II II IE |R IE |D IB |R |T I lllllllllllll I A 

0 IS IN |G Ifl IQ IG |0 IG IB | lllllllllllll | L 

C |fl |G IB IS |U IE |R IE |R I lllllllllllll 1 1 

E IS |0 IE |V IE | IT | IT | lllllllllllll 10 

S IL I I |E | | | | | | lllllllllllll | 



LOCATION OF DISC REQUEST OR nOVE nSG 



COflPLETION nESSAGC 

n in IB IS II m I llllllllllllillllllllllll in 

S 10 |L IC 10 IS I llllllllllllillllllllllll I S 

G IV |K |H |U |G I llllllllllllillllllllllll I G 

p ie io ie m m Miiiuiiiiiiiiiiiiitiium 

R |R IL ID II IB | llllllllllllillllllllllll I A 

0 IE |K |fl IT 10 I llllllllllllillllllllllll I L 

C 10 I IS | |R I llllllllllllillllllllllll 1 1 

I I IG I IT | llllllllllllillllllllllll |0 



flAKE PRESENT DEFERRED QUEUE (PCB INDEX) 
RELEASE PAGE COUNT 



nPQLINK 
PHGECNT 



RB-16 I SPECIAL REQUEST TABLE PTR (SRT TABLE REL) I SPECREQTRBPTR 



G.00.00 
2- 21 



rtenory Management 



Subreqion header (Reserved Regions) 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



C |R |R 

A IE 10 

C IF |C 

H I 



SUBREGION RSSIGNREKT STRTE 



IIIIIIIIIIUHII/lllllllllim I 

lllllllllltlllllllHIIIIlllin 0 

IIIIIUHIIIilllllll/llHIlin s 

iiiiiiiiiiiiiiiiiiiiiiiimin t 



Rfi-14 
RB-13 
RB-12 
RB-11 



RB-7 
RB-6 
RB-5 
RB-4 
RB-3 



SUBREGION SIZE 
SUBREGION DISPLBCEBENT IN KAIN flEfl. PAGES 
WRITE REQUEST POINTER 



OBJECT IDENTIFIER 



FREEZE COUNT I LOCK COUNT 

WHITE DISABLE COUNT I I/O FROZEN COUNT 

LDEV | HIGH ORDER DISC ADDRESS 

LOU ORDER DISC ADDRESS 
IlltllUllllllIlllllllllllilllllltlltlllllllll 
llllllllllllllllllllllllllllllllllllllllllilll 



TII1E OF 
ARRIVAL 

IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIHIII 



SS 
SO 

UREQP 
OBJIOENT 

LKFZCHT 
UOIOFZCNT 
HOOA 
LODR 



G.00.00 
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Henory nanagenent 



Subregion Header (Cached Regional 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
SUBREGION ASSIGNMENT STATE 



Htnory flanagenent 



Region Header and Trailer Field Descriptions 



Region Rssignnent State 



R8-14 
RB-13 
RB-12 
RB-11 



RB-7 
RB-6 
RB-S 



SUBREGION SIZE 
IV | SUBREGION DISPLACEflENT IN HMH HEN. PAGES 
URITE REQUEST POINTER 



r Miiiiiiiiiiiiiiiiiiiiiiiiinn i 

o Miiiiiiiiiiiiiiiiiiiiiiiimn o 

c Miiiiiiiiiiiiiiiiiiiiiiiiinn s 

\lltlllllllllllllllllllllllltl\ T 



OBJECT IDENTIFIER 



PREVIOUS CACHED REGION (ADDRESS OF PD 
FIELD OF PREVIOUS CACHED REGION) 



Region Assigned Flag 
Region Reserved Flag 
Region Available Flag 
Region Cleaned Flag 
Size Change Pending Flag 
Region Locked Flag 
Region Frozen Flag 
Region I/O Frozen Flag 
LSTT segnent 
Not used 



UREQP 
OBJIDENT 



IOCNT, 



(15:1) Blocked Lock rtigration in Progress Flag 
On-Going I/O Count 

= If of on-going I/O's in the region which nust complete 
before the initiation nessage can be processed. 



INITnSG, Initiation Message 



LDEV 



I HIGH ORDER DISC ADDRESS I HODH 

— 1 

LOU ORDER DISC ADDRESS I LODR 

- I 

NEXT CACHED REGION (ADDRESS OF ND 



FIELD OF NEXT CRCHED REGION) 
TIflE OF 
ARRIVAL 
DISC RDDRESS CSL(8) 



I CACDADISP 



.(0:1) flessage Processed Toggle Switch 

.(1:1) flessage Externally Disabled Flag 

.(2:1) flessage On-going I/O Disabled Flag 

.(3:1) Queue Segnent Read Disc Request Flag 

.(4:1) Incore dove Request Flag 

.(5:1) Expansion Request Flag 

.(6:1) Garbage Collection Flag 

.(7:1) flessage Aborted Flag 

.(8:1) Release Residual Pages Flag 

.(9:1) Ok to start conpletion flag 

.(10:5) Not used 

.(15:1) flessage Valid Flag 

Initiation flessage Auxiliary Infomation 
= DRQ relative index of segnent read disc request if INIThSG. 
QREADREQ=1 
or 

E +/- Displacenent to initiation nessage for noves 
and expansions. 



COtlPIISG, Conpletion nessage 



.(0:1) Message Processed Toggle Suitch 

.(1:1) Segnent Hodif ication Required 

.(2:1) Block Lock Request 

.(3:1) Send Scheduler R nessage 

.(4:1) Awaken R Device 

.(5:1) nessage Rborttd 

.(6:9) Available 

.(15:1) Message Valid Flag 



G.00.00 
2- 23 



G.00.00 
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ften&ry Flanagenent 



flPQLINK PCB relative index of the HEfiD of the make present 
queue. 

PflGECNT, Release Page Count 

=8 of extra pages to release before processing initiation 
message. 

SPECREQTRBPTR, fl Special Request Table relative index to the list 
of devices queued on this segnent. 

SfiS, Subregion Rssignnent State 

. (0:1 ) Cached region 
.(1:1) Referenced 
.(2:1) Recover Overlay Candidate 
.(13:3) I/O Status fron region fetch 



SS, Subregion Size 

SD 7 Subregion Displacertent 

.(0:1) Dispiacenent Count Valid Flag 
.(1:15) tt Pages to Base of Region 

UREQP, Urite Request Pointer 

= ORQ Relative Index of Disc Urite Request uhen the 
Data Segnent in the Subregion is in notion Out 
Uhen the region belongs to a cashed donain which 
is napped (i. e. OBJIDENT = 30000/non zero nunber) 
this word is non zero. If the cashed donain is not 
napped UREQP is zero. 

OBJIDENT, Object Identifier- has standard object identifier fornat 

LKFZCNT, Lock and freeze count 

.(0:8) Nunber of tines region has been frozen 
.(8:8) Nunber of tines region has been locked 

UDIOFZCNT, Iofreeze count 

.(0:8) Hot used 

.(8:8) Nunber of tines region has been iofrozen 

For regions belonging to cashed domains, the above two words 
contain the absolute address of the PD field in the previous 
region belonging to a cashed donain. 

HODfl, High order disc address in virtual nenory of this 

region 

LODR, Low order disc address in virtual nenory of this 

region 

ND, Next cashed donain link for cashed donain regions 

only. Contains the absolute address of the HD field 
of the next cashed region. [ 2 uords ) 

G.OO.OO 
2- 25 



flenory tlanagenent 



RRRTIflE, Arrival tine, contains the tine at uhich the segnent 
contained in the region became present 

CfiCDRDISP Valid only for regions containing a cashed donain, 

this uord represents the disc address ( in one word ) 
of the segnent contained in the region. This uord 
which exists in each member of a linked list of cashed 
domains, is used as the target word during the LLSH 
instruction. 



Space Rllocation Structures 



lis of I1PE V/P and V/E, one doubly linked list structure is used instead of 
the nultiple lists ordered by size as in HPE IV. Sysglob locations X250 
through Z253 contain the respective head and tail (bank & address) of the 
available region list. These four words have in essence replaced the RRSBtl 
and flRL data structures in MPE IV. Memory allocation and deallocation is 
handled through PUTQNHRL and TflKEOFFRRL. The search for an available region 
of the desired size is done vis the LLSH instruction. The fornat of the list 
is the following : 

Sysglob 2250 & Z251 points to the absolute address of the NEXT LINK 
field (two uords) in the first available region on the list. The 
NEXT LINK field in the first available region points to the ab- 
solute address of the NEXT LINK field in the second available 
region and so on. It is worth mentioning that in addition to 
having a NEXT LINK field, each available region also contains a 
PREVIOUS LINK pointer, which makes nanagenent of the list both 
easier and faster. 



6.00.00 
2- 26 



Disc Layout 



Disc Layout 



CHHPTER 3 DISC LAYOUT 
Svsten Disc Layout 



SECTOR # 
Z 0 
1 
2 
3! 
4 
S 
6 
7 
10 
1 



DISC LABEL 
DEFECTIVE TRUCKS/SECTOR TABLE 
COLD LOHO CHANNEL PROGflRfl FOR HP-IB 
HER DUMP CHANNEL PROGRAM FOR HP-IB 



4 \ 

5 

6 



CODE FOR 
INITIAL PROGRAMS 
"BOOTSTRAP" 
SECJ1ENT 



LOU CORE (CST POINTER, 01, 21, POINTER) 
TEMPORARY CST (INITIAL PROGRAM) 
INTERNAL INTERRUPT HALTS 



BOOTSTRAP STACK 



REMAINDER OF SIO COLD LOAD PROGRAM 



VARIABLE 
LENGTH 



-I FOLLOUS 

| IMMEDIATELY 

| AFTER 

I BOOTSTRAP 

| SEGMENT 



G.00.00 
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Disc Layout 



Svsten Disc Layout (Cont.) 



SYSDB 
W 30/1 31 



SYSTEM DIRECTORY 



VIRTUAL MEMORY AREA 



INITIAL PROGRAM SEGMENTS 
(EXCEPT BOOTSTRAP SEG) 



SYSTEM FILES 
(FROM COLD LOAD TAPE) 



» NOTE: INITIAL 
TRIES TO 
ALLOCATE 
DIRECTLY AFTER 
THE FREE SPACE 
MAP. HOUEVER, 
THIS MAY 
VARY DEPENDING 
ON DELETED 
OR REASSIGNED 
TRACKS 



VOLUME TABLE 

INITIAL PROGBSa STACK 

REMAINING INITIAL CODE SEGMENTS 



G.00.00 
3- 3 



Systen Disc Layout (Cont. ) 



SECTOR » 
X 



DISC COLD LOAD INFORMATION TABLE 
DISC COLD LOAD INFORMATION TABLE 
DISC COLD LOAD INFORMATION TABLE 
SYSDUMP/IHITIAL COMMUNICATION RECORD 
DISC COLD LOAD INFO. TABLE EXT. 
DISC COLD LOAD INFO. TABLE EXT. 



SECTOR » 



|33 



G.00.00 
3- 2 



Disc Layout 



Systen VoluiiB 



Disc Label (Sector 0 of Disc) 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
0| CONTROL ORDER 



«CYL/ARC 8» 



READ ORDER 
<(HEM ADORESS» 
SIO JUMP ORDER 
5| «HEM ADDRESS) > 

6 !///////////////// 1 DISC TYPE 



I 



I DISCSUBTYPE 



COLO LORD ID 



DISC BOOTSTRAP 
SIO PROGRAM 
(SYSTEM DISC 
ONLY) 

Uords 0-5 contain 
the ascii string 
"SYSTEM DISC" for 
HP-IB Systens 



IF UORD XV 
CONTAINS A "1" 
A FORMER SYSTEM 
VOLUME HAS BEEN 
SCRATCHED. 



I- - 

I CYL j 


I 


HEAD 


I 


SECTOR I 



ICF UCS 

IMAGE 

POINTER 



G.OO.uO 
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Disc Layout 


Disc Layout 








Svsten Voiune fCont.) 
271 


1 




Serial Volune 














0 

1 


0 (: STORE) 




10 
1 

n 




1231 CVL 






2 


or 




i 

12 




1241 HEAD | SECTOR 






3 


COLD LOAD SIO CHANNEL PRO&RRfl (N0N-HP-I8 
MACHINES ONLY). FOR HP-IB MACHINES, COLD 


1 

13 










4 


LOAD CHANNEL PROGRAM IS IN SECTOR 2 AND 
SOFTDUMP CHANNEL PROGRAM IS IN SECTOR 3. 


1 

14 
11 

5|6 










6101 234567 


i i i i i 
8 9 0 1 2 3 4 




i 


-i 




6|SC|MV|SR| | TYPE | SUB-TYPE 


16 


SC = 1 ~> 


170| 


1 1 20 




7 






17 


SCRATCH VOLUME 
IW = 1 ==> MASTER 


1711 DISC FREE SPACE HHP OK FLAG 


1121 




10 


0 




1 

18 


VOLUflE OF PV SET. 
SR = 1 ==> 


1721 DISC FREE SPACE HAP DESCRIPTOR TABLE CHECKSUM |122 




11 

4 






1 

19 


SERIAL DISC 


173| DISC FREE SPACE DESCRIPTOR TABLE DIRTY FLAG 


1 1 23 




12 


"S" | 


"E" 


no \ 


1741 

1- DISC FREE SPACE DESCRIPTOR TABLE ADDRESS ■ 


1124 

-I 




t 

13 


1 R' J i 


,.„„ 


m 


I 

I VOL NAME 


1?5| 


1125 




14 


"I" ; 


"S" 


i 

112 1 "SERDISC" 


176| 

| DISC FREE SPACE BITMAP ADDRESS 


1126 
-I 




15i 


"C" | 


SDISC VERSION NUMBER 


-+ 1 
113 / 


177| 


1127 




16 1 UORDS PER SECTOR 




114 


\ 








17| SECTORS PER TRACK (CARTRIDGE TAPE = 1) 


115 


I 
1 








20| SECTOR ADDRESS OF BEGINNING OF TAPE (BOT) 

21 1 DOUBLE ADDRESS OF 
1- 

221 END OF TAPE (EOT) 


116 

117 
-I 
I IS 


1 

1 

1 SERIAL 
> DISC 
1 INFO 
1 








23| 

i 


DOUBLE ADDRESS OF 




H9 


1 

1 








24| END OF DATA (EOD) 




-1 
120 


1 

/ 








251 


CYL 




121 


ICF UCS 

IMAGE 

POINTER 








261 
+ 


HEAD | 


SECTOR 


122 


G.00.00 
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Disc Layout 


Disc Layout 








Serial Voiune (Cont.) 






Raster Volune 








1 

RESERVED FOR FOTURE UCS 

1221 


-t 

1 23 

\k 






01 
11 
21 
3| 
4| 


0 




10 
H 
|2 
13 
K 


1231 CVL 


-+ 
1 83 






SI 






|5 


124j HEAD | SECTOR 


I84 




SC - 


SCRATCH 6|SC|!W|SR! 


IS TYPE 11112 


5UB-TYFE 1516 








W = MASTER 7) GENERATION INDEX 




|7 








SR = 


SERIAL 10| 
VOLUME 11| 


0 




|8 
|9 










121 
131 
141 
151 


VOLUME 
NAME 




no 

111 
112 
113 










161 


INITIAL DATE 




114 










171 


DIR6ASE 




115 0 IF NOT 










201 


DIRSIZE 




116 VOLUME 










211 
221 
231 
241 


ACCOUNT 
NAME 




117 
118 
119 

120 










251 
261 
271 
301 


GROUP 
NAME 




121 
122 
123 
124 


c.oc.oc 

3- 7 




i 
I 






G.OO.CO 

3- ? 







Due Layout 



fleeter Yolum f ftnt. } 



311 
321 
331 
Ml 

3SI 



volm set 
Nsnt 



125 
\H 

127 HESOER 
,28 



vs vtab 

HESDER « 
8 ENTRIES 3610 VCOUNT 31 

COPIED FROl 

VSET OEFM 37| 
I« SYSTEB 401 
DIRECTORY 41| 
421 



VOUfiE 

Nfint 



431 

441 SUB-TYPE 
451 



129 

130 

i31 
f 32 

1 33 VtJLUnC 

134 ENTRY 0 

1 35 
I3S 



HSI 



1 78 



V0U1BE 
ENTRY 
7 



170| 

I- 
1711 



Disc Fret Space nap OK Flag 



1120 
-I 
1121 



1721 DISC FREE SPACE DESCRIPTOR TflBLE CnECKSUfl 1122 
I I 

1731 DISC FREE SPSCE DESCRIPTOR TflBLE DIRTY FLAG ]123 
1 - 1 

'741 1124 
I- DISC FREE SPACE DESCRIPTOR TflBLE ADOAESS -I 

"5| ii 25 



1761 
I- 
1771 



■ DISC FREE SPACE BITtlAP ADDRESS • 



1126 



0.00.00 
3- 9 



Disc Layout 



Slave Voliine (Cont. ) 



1701 

I- 
1711 

I- 



DISC FREE SPACE MP OK FLAG 



1120 
-I 
M21 
-I 



1721 DISC FREE SPACE DESCRIPTOR TABLE CHECKS* |!22 



1731 DISC FREE SPACE DESCRIPTOR TABLE DIRTY FLAG 1123 



I- 



174| 



-I 



I-- DISC FREE SPACE DESCRIPTOR TABLE AOORESS -| 



1124 



1751 



| 



176| 



1771 
I- 



OISC FREE SPACE BITHHP ADDRESS • 



MZ5 
-I 

1126 
-I 
1127 



Due Layout 

Slave Volune 

01 10 

11 II 

21 0 ■■> 

l\ I' 

SC ■ SCRATCH 51 | 

VOLUHE - 

nv = nasTES 6iSC!»ViSR| :s :y?e 11 :*?£ ; sic 

VOLUnE = 0 — -- 

SS = SERIAL 7| '^NERFTiaN INDEX }? 

vQLUHE -- 

10! 0 is 

111 19 

121 no 

13! VuitlE 111 

14| HfiflE M2 

•5i M3 

1SI IMTIAL DATE ,14 

17! 0 (is 

201 i- 6 

211 117 

22 1 aCCOUNT jis 

22 1 »«HE 19 

241 i jo 

251 "jl 

2SI GROUP ^22 

271 MME (23 

301 124 

31 1 *:S 

32! ,'OljSE SET a 

331 »;^E |27 

128 



0.50.00 
3- 10 



Disc Layout 

Dgfactive Tracks T aSie (Sector 1 of Disc) 
(lot used un CS-SO 3;scs) 

0 1 2 3 4 5 6 7 J 9 10 11 12 13 14 IS 

l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l"! 

01 « OF DEFECTIVE TRACK ENTRIES (N) |0 

i — I 

II DEFECTIVE TRACK NUrtSER I "C jl 120 DEFECTIVE 

I " - i 'SUCKS naxlltUI 

21 OEFETOE TRACK NUrlSER ! OTC !2 

i i 
1 ■ i 

I J- _J 

1671 DEFECTIVE TRACK NUHBER I OTC |119 

I I 

1701 DEFECTIVE TRPCK HUflSER i DTC 1120 

I I 

"11 j 121 

I | 

"21 |122 

I RESERVED FOR | 

173| FUTURE USE | -23 

17«i |t24 

I | 
17S| Mz5 

I - I 

1761 NEXT AVAILABLE ALTERNATE TRACK |126 

I " I 

1771 LOGICAL DISC PACK SIZE (CYLINDERS) 1127 

I " I 

OR • OF TRACKS IF FH DISC 

DTC (DEFECTIVE TRACK CODE) 

0 suspect 

1 suspect alternate 

2 deleted 

3 reassigned 

NOTE: The situation where there are tvo entries for the sane track, n. ane 
having a DTC of 0 (suspect) and the other having a DTC 3 (reassigned) results 
fron a situation where the disc driver could not 'read - ' Unreadable) the ad- 
dress of the particular track. 



G. 00.00 

3- 11 
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Disc Layout 



Diic Layout 



(tlit DSCT estate on dwice type 3 (CS-») diect) 



0 


1 2 3 4 5 6 7 t 9 10 11 12 13 14 15 


0 1 


NLTOER OF ENTRIES IN THE TABLE 


1 0 


<1 I 


INOEK TO THE FIRST ENTRY (S) 


1 1 


H I 


ENTRY SIZE (2) 


1 5 
1 t 


13 1 


naxinun numer or entries (6i) 


1 3 


M 1 


0 (RESERVED) 


1 4 


15 1 


0 (RESERVED) 


1 5 

4 


IS 1 
1 


FIRST DEFECTIVE SECTOR ENTRY 
(0OU8LE-UORO LOGICAL SECTOR ADDRESS) 


1 6 
1 

+ 


110 j 


SECOND ENTRY 


1 S 

1 


11! 1 


THIRD ENTRY 


1 10 



1176 I 

1177 I 



IKWinun DEFECTIVE SECTOR ENTRY 



I IK 
I 127 



».«.rvri Aga Bit n. (Sector 4 af th. Svtttn Olac) 

The Firet 400 jectore of the fylten due at reeerved for Initial'l uae. 
Thie m contama pemantnt date atmcturee for the boot. It ia alio used 
ae a tenporary atoraje area for data dunno, epann,. RU other systen 
volunea and private volenti reserve only th* firat 10 lector* of the disc. 
They do not havt a reeerved area bit nap. 

The bit nap eontaine 1 bit par atctor. R ■!' warn the aector it fraa. 



130 I 
I— 

131 I 



RESERVED BRER 
SIT n» 



RESERVEO FOR 
FUTURE USE 



I 0 



I 

I 24 
-I 
I 2S 
I 

I 
I 
I 



1177 I 



I 127 



Unlike tha DTT, entriet in the DSCT art not pernanent. Once a auepect aector 
ia handled by INITIAL or VIHIT, lta entry ia renoved fro™ tha table. Thga, 
thia table containt only unprocaaaed eutpect sectore. 
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91 
10 
11 
12 
13 
14 
15 

I- 
1*1 

I- 
171 

«r 
i 

191 

I- 



201 

I 



Diac Layout 



Diac Cold load Tnfomation Tahl. ISectora 21-30) 



POINTER TO TRBLE INfORHlTION 
"pOfflTH TO TGWPJHRY CST WO 



• OF ENTRIES TO RENO ON DISC COLD LORD 



tt OF CODE SEGKNTS IN INITIAL 



1 

| FflEFTR 
1 

| TCSTPT* 



i NRERO 

-I 

I NVTCST" 



INITIAL'S 00 VALUE 



INITIAL'S OL VRUAT. 



INITIAL'S Z VRLUE 



INITIftl'S 0 VALUE 



TjaTIRl'S 3 VRLUE 



I SYSDISC TYPE I SUBTYPE 



COLD LOW ID 



LOG FILE HUME* 



DIRECTORY DISC 
ADDRESS 



INITD6 

INITDl 

I«TZ 

INITO 

INITS 

DISCTST 

COLD'LOAD'IO' 

LOO' FILE* NUN' 

OIRROR 



UDEV 1 VIRTUAL nthtJRY 

disc reotEss 



• LOG PROCS 



LOG ID'S 



VIRJ1EIWDM 



ft IN TABLE 
DISC RODRESS 



DIRECTORY SIZE 



I 

| RIKADR 

I 

-I 



21IMECT0RS IN VIRTUAL "ERORY REOIOH OF LOEV 1 



I DIRSECT 
| SECTORS IN LDEV1VH 



22 1 

I- 
23I 

I- 
24I 

I- 



RIN TABLE SIZE 



! RINSECT 



• OF RINS 



RINS 
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Diac Layout 



Diac Cold load Informati on Table (Cont.) 



I- 
251 



« of global RINS 



261 



ITLIRURY 



271 HIGHEST VOL « 

I 

211 
I 



| R OF VOLUflES 



291 

301 
I 

311 

I- 
321 

I 

331 

I- 
341 

I 

351 

I- 
361 

I 

371 

I- 
3»l 

I 

391 

I- 
40| 

41 

42 

43 

44 

45 1 



DISC COLD LOAD ENTRY POINT 



SYSTEN DISC DRI NUH6ER 



JOB nASTER TABLE 
DISC ADDRESS 



100 DISC ADDRESS 



000 DISC ADDRESS 



UELCOre HESSAGE (DST 47 
DISC ADDRESS 



10) 



UELCORE BESSAGE (DST 48 
DISC ADDRESS 



10) 



LOG 10 RODRESS 



LOG TAB RODRESS 



LOG ID SIZE 
LOG TAB SIZE 



1 



GRINS 
Tl'Tapt cold load 
LOflO "ODE 
Rl»Reload 
RY=rtcovery 
H'VOL' 

DtSCENTRY 

SYSDISCDRT 

JNATLOC 
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Disc Cold Load Infomation Table [Cent. 1 



SIZE IK UORDS 
I1EI10RY SDDRESS 



'DRIVER 
IflBLE 



DISC SDDRESS 



SIZE IN UORDS 
HEflORY ADDRESS 



*CTAB0 



DISC ADDRESS 
SIZE IN UORDS 

nEnoRy address 



DISC ADDRESS 
SIZE IN UORDS 
HEUORY ADDRESS 



COHHUNICR- 
TION SUB- 
SYSTEH 
DRIVER 
TR8LE 



disc address 
size in uords 
hehory address 



connuNicn- 

TION SU8- 
SYSTEH 
DEFINITION 
TABLE 



DISC ADDRESS 
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Disc Cold Load Infomation Table [Cont. ) 



SIZE IN UORDS 
flEriORY ADDRESS 



ClfflfflJMCB- 
SUBSYSTEtl 
TABLE 



DISC ADDRESS 
SIZE IN UORDS 
flEEIORY ADDRESS 



LOGICAL- 
PHYSICAL 
DEVICE 
TABLE 



DISC ADDRESS 
SIZE IN UORDS 
HEUORY ADDRESS 



LOGICAL- 
DEVICE 
TABLE 



DISC ADDRESS 



SIZE IN UORDS 
HEHORY ADDRESS 



DEVICE 
CLASS 
TABLE 



DISC ADDRESS 
SIZE IN UORDS 
flEOORY ADDRESS 



FAEFTR+35 



V0LU1IE 
TABLE 



DISC RDDRESS 
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Disc Layout 



Disc Cold Load Infomation Table (Cont.) 



Disc Cold Load Information Table (Cont. 



SIZE IN UORDS 
HEHORY ADDRESS 



LOGICAL 
DEVICE 
TABLE 
EXTENSION 



DISC ADDRESS 
STACK SIZE 
HEUORY ADDRESS 



INITIAL'S 
STACK 



DISC ADDRESS 
SIZE IN UORDS 
HEnTJRY ADDRESS 



DEVICE 
CLASS 
TABLE 
HEADER 



DISC ADDRESS 
SIZE IN UORDS 
HEUORY ADDRESS 



TERfllNAL 

DESCRIPTOR 

TABLE 



DISC ADDRESS 
SEGHENT SIZE 
HEUORY ADDRESS 



INITIAL/ 
SYSDUHP 
COHHUNICATION 
— RECORD 



DISC ADDRESS 



SE GHENT SIZE 
HEHORY ADDRESS 

DISC ADDRESS 



(HORE SEGHENTS OF INITIAL) 
ININ 



INITIAL'S 
SEC-HEHTS 



INITIAL Pronran CST Hao 



FREFIRtgO 



LOGICAL 


PHYSICAL 




CSffl 


CSJJ 


SEGMENT NAHE 




1 


ININ * 


i 


2 


BOOTSTRAP |- 


2 


3 


RESIDENT / 


3 


4 


HAINSEG1 \ 


4 


S 


HAINSEG1A | 


5 


6 


CONFIGURE | 


6 


7 


DEFCT RACKS! 


7 


10 


SETUP |- 


10 


11 


TAPEIO | 


11 


12 


FILEIO | 


12 


13 


DISCSPACE / 


13 


14 


DIRECTORY! 


14 


15 


DIRECT0RY2 


15 


16 


SL PROGRAn 


16 


17 


PROCESS 


17 


20 


HAINSEG1B 


20 


21 


HAINSEG2 


21 


22 


{1AINSEG3 


22 


23 


HAIHSEG4 



core resident 



Inoncore resident 
I but present in core 
- 1 at conpletion of 
I cold load 



*code segnent suapping starts at conpletion of flfllNSEGI 
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Disc Layout 



SYSDUflP/Initial Communication Record 



HIT VERSION 
nil UPDATE 
HIT FIX 
VERSIOH 
UPOATE 
FIX 

EXP SYSTEfl HR, 
HIGHEST ORT 
HIGHEST LDEV 
HIGHEST VOL/* OF VOLS 
» OF RDO'L DRIVERS 
COLD LOAD COUNT 
FILES DUHPED 
SERIAL DISC LORD 
THPE RECORD SIZE 
DISC COLD LORD EHTRV 
flAX INITIAL SEG SIZE 



SPARE 
SPRRE 
SPARE 

DEV CLASS TAB SIZE 
TERfl DESCRIPTOR SIZE 
OLD VTB8 SIZE 
OLD INFO SIZE 
CS TABLE SIZE 
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SVSDUflP/Initiai Communication Record (Cont. ) 



CONVERSION BITS UORO 1 



CONVERSION BITS UORD 2 



CONVERSION BITS UORO 3 



CONVERSION BITS UORO 4 



SPARE 
SPARE 
SPARE 
SPARE 
SPARE 
SPARE 

LOG FILE NUflBER 
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Disc Layout 



Cold Load Information Table Extension 



The Cold Load Information Table Extension is a part oF the Cold Load 
Information Table that has no use in booting the system. It exists for dif- 
ferent systen level processes to hold information that uould only be created 
during a RELOAD, fl good example of this is the systen log file number. This 
is only created on a RELOAD, and changed whenever a log file is full or a 
boot (other than a RELOAD) is performed. 

In order to protect the Cold Load Info Table, the extension Has created. In 
this uay NO I/Os should be performed to the Cold Load Information Table 
during RPE operation. Houever to process data into the Cold Load Info 
Extension a process nust use the access routine "PROCESS'COLD'IORD'INFO", 
The exact calling sequence can be found in KERNE LD. 

The Cold Load Information Extension is 2 sectors long and immediately follows 
the SYSDOTIP/Initial Communication Record starting at sector address 1*31 on 
logical device 1. 

The assigned entries are as follows: 



RESERVED FOR FUTURE SYSTEfl USE 



SYSTEfl LOGGING FILE NUMBER 



NETUORK flANAGEflENT LOGGING FILE NUflBER 



NETUORK BANAGEflENT TRACE FILE NUflBER 
FULL/PARTIAL COflflAND DUflP DATE 



NOT CURRENTLY ASSIGNED 



Disc Layout 



Virtual Oisc Space flanaqenent Structures 



Disc space for data segments is allocated from reserved regions of systen 
volumes which have been assigned the virtual menory supporting (VflS) at- 
tribute. The data structure used for accounting and management of the vir- 
tual disc space of the various VflS volumes is the Virtual Disc Space Table 
(VDSflTABJ. This structure consists of a circular list of entries, one for 
each VflS volume. Each entry contains the information defining the state of 
the virtual memory region on that volune. 



Virtual Disc Space flanaqenent TaclE 



VDSBTAB DST# = 3B (M?) 

VDSflTABPTR = Absolute(Z1026) = SYSGL09 Z26 



GenEral Structure 



I 
I 

+ — ) 



* VfiS VOLUflES ! 
FIRST TO LOOK AT|-» 

-* ! 

I I 

NEXT IN LIST I I 
I I 

— t I 

l<-' 

NEXT IN LIST I 
I 

t 

NEXT IN LIST | 
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VDSnTRS Entry 0 Fomat 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

VDSMTABOOI ttUGRDS IN VDStIT 

I — 

VDSMTAB01 I » SYSTEM VOLUMES UHICH HAVE VIRTUAL MEMORY 

I - 

VDSMTAB02I INDEX OF NEXT ENTRY TO ALLOCATE FROfl 

I 

VDSMTAB03I Vfl PACE SIZE (512) 

I - 

VDSMTAB04I « SECTORS/Vn PAGE (4) 

I 

VDSMTAB05I OFFSET FROfl ENTRY TO BITMAP (Z20) 

I - - - 

VDSMTAB06I TOTAL » VM PAGES CONFIGURED IN SYSTEM 

I 

VDSMTAB07I LEAST # OF Vtl PAGES THAT HAVE EVER BEEN AVAIL. 

I— - - 

I 

I VDSnTAB Z10-Z17 UNHSSIGNED 
I 

I 



Disc Layout 



TABLE LENGTH 
VMSVOLUHECNT 
STflRTENTRY 
iVNPAGESIZE 
SECTORSPERVHPAGE 
OFFSETTOBM 
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Disc Layout 



Volume Table 

SIR #22=%26 
DST #29>M5 

rero entry 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
i-cJ I — I — 1 — f — | — | — | — | — | — I — J — 1 — I — | — [ — | — | 

I # OF ENTRIES I | 
0| (NOT COUNTING ZERO) I ENTRY SIZE=16(8) |0 

I— - 1 

1| COLD LOAD ID |1 

! i. 

2| SYSVOLNUn ! 
| | 

3 1 VIRTUAL MEMORY INTEGRITY NUMBER 

I — I 

i i 

1 5 1 i!iiiiiiimiiimiiiiitniiiimiiiiiiiiiiiiu\n 
i— - 1 



Disc Layout 



VDSnTAB General Entry Fornat 



Uord 0 
Uord 1 
Uord 2 
Uord 3 
Uord 4 
Uord 5 
Uord 6 
Uord 7 
Uortl 210 
Uord 111 
UORD Z12 
Z13-Z20 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



INDEX OF NEXT ENTRY IN CIRCULAR LIST 
LDEV* 



STARTING SECTOR OF DEVICE'S 
VIRTUAL MEMORY REGION 



* SECTORS IN DEVICE'S 
VIRTUAL MEMORY REGION 



* PAGES IN DEVICE'S VIRTUAL MEMORY REGION 
H OF PAGES AVAILABLE IN DEVICE'S VTI REGION 



» OF VAUD UORDS IN DEVICE'S BIT HAP 
SIZE OF SMALLEST RECENT HISS 



SMALLEST NUMBER OF PAGES EVER AVAILABLE 
UN ASSIGNED 



DEVICE'S VIRTUAL MEMORY BIT MAP 
I I I I I I I I I I I TTT 
I I I I I I I I I I I I I I 



NEXTINLIST 
LDEV 

HOSTARTSECTOR 
LOSTARTSECTOR 
TOTAL SECTOR 
COUNT 

TOTAL PRGECNT 
PAGES AVAILABLE 
BBLENGTH 
SnALLESTllISS 



•"COMMENT: A bit on in a device's VHBIT HAP 
==> Corresponding VM page is free. 
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Disc Layout 



Typical Private v'olune Entry 



INDEXED BY 
VOLUME It 



VOLUME 
NAME 



GROUP 
NAME 



71 

I- 
101 
! 

111 
I 

121 
I 

131 
I- 



RCCOUNT 
NAME 



I LOGICAL DEVICE It 
14| (=0 IF NOT MOUNTED) i 

I- - 

I IVSET VTABX I 
151 I | 
I — 



|VHS|UN|NS|SC 
III! 



NS - NON-SYSTEM 

DOMAIN 
SC - SCRATCH 
UN - UNREADABLE/ 

UNFORMATTED 
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Disc Layout 



Typical Systen Volune Entry 



VOLUBE 
NBtlE 



01 

11 

21 

I 

31 

I - 

41 
51 

I 0 
6! 
I 

?i 

I 

101 STARTING SECTOR OF VOLUHE'S VH (0 IF NONE) 
I 

111 

I - - 

121 

I NUMBER OF SECTORS RESERVED FOR VII ON VOLUME 
13| (0 if none) 



I LOGICAL DEVICE « I 
14| (=0 IF HOT nOONTED) I 

I 

I IVSET VTflBX | 

151 I | 

I 



IVHSi UNI HS I sc 

I I I I 



INDEXED BY 
VOLUflE « 



■ NON-SVSTEH 
OOnRIN 

• SCRATCH 
- UNRERDRBLE/ 
UNFORMATTED 

■ VIRTUAL nEHORV 
SUPPORTING 
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Directory 



CHRPTER 4 DIRECTORY 
Introduction to the Directory 

SYSG10B cells: 

DIRSfiSE <- — absolute disc addr of base [SYSGL0B+X130 AND Z131] 
Directory on disc consists of a contiguous area: 
DIRBRSE - 



DIRECTORY 
BUMP 



DIRECTORY 
DATA 

Entries 

and 
Indices 



j The bitnap defines the available/used 
I sectors in the directory. If the 
directory is <= 6112 sectors, then 
I the bitnap uill occupy 3 sectors. 
I If the directory size is > 6112 
I sectors, then the bitnap uill occupy 
I 32 sectors uith DIRBASE pointing to 
j the 30th sector of the bitnap. fl 
zero bit in the bitnap represents a 
used sector. Uords 0 and 1 of the 
bitnap are ignored. 



Directory entries contain pointers 
uhich are sector displacements 
relative to DIR8RSE. Entries and 
indices are grouped into "blocks". 



The capacities for accounts/groups/users/files are dependent on their 
block sizes. 

* SYSSAIBSIZE Systen acct index block size (3 sectors) 
SYSAUIBSIZE fleet, user index block size (1-3 sectors) 
SYSAGIBSIZE fleet, group index block size (1-3 sectors) 
SYSGFIBSIZE Group file index block size (2 sectors) 
SYSGVSIBSIZE Group volume set definition ind. blk. size(1 sector) 

* SYSAE8SIZE Acct. entry block size (3 sectors) 
SYSUE8SIZE User entry block size (2 sectors) 
SYSGEBSIZE Group entry block size (2 sectors) 
SYSFE8SIZE File entry block size (2 sectors) 
SYSVSEBSIZE Volume set definition entry block size (1 sector) 
SYSBAXBSIZE maximum of above, (used to initialize DDS. ) 

*These values are used once for the creation of the (root) system, 
account index or neu systens. This root index is aluays at address 
DIRBASE+3. 
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Directory 



Overvieu of Directory 



I SYSTEM I 

/ / \ \ 
/ / \ \ 
/ / \ \ . . . 

Ill I 
I I I I 

/ \ 
/ \ 
/ \ 
/ \ 

IUSERSI IGSOUPSI 

/ / \ / \ \ 

I I \ I \ \ 

I I I I " I I I I I I 

I I I I I I I I I I GROUPS 

\ / / \ 
I \ 

USERS / \ 

/ \ 

I WETS | | FILES | 

/ I I \ 

I I I \ 

I II \ 

VSETS/ || I I I I I I FILE 

VCLASSES II I I I I II POINTERS 

"i T"\ 1 
-II / 

/ 

ENTRY FILE 

Overview of Directory 
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Directory Data Segment 



Directory 

Directory Data Segment (Cont.) 



0 I- 



17? 
200 
201 
202 
203 
204 
205 
206 
207 
210 
211 
212 
213-240 
241-266 
26? 
270 
271 



SECTOR 
BUFFER 
128(10) UORDS 



-I 0 



I- 



BDJUST (DB-DL) 



XTYPE (INPUT PARH) 



XHVTABX 



XANAHE (OB REL ADDR) 
XGUNAHE (DB REL ADDR) 
XFNAI1E (DB REL ADDR) 





uiiiiiiiiiiiiiiiiiiiniiin 


192 


127 




iiiuiiiiiiiiiiiiiiiiiiiin 


193 


128 




iiiiiiiiiiiiiiiiiiiiiiinn 


194 


129 




iiiiiiiitiitiiiiiiiiiiiim 


195 


130 




iiiiimiiiiiiiiiiiiiiiim 


196 


131 




iiiiiiiiiiiiiiiiiiiiiiinn 


197 


132 
133 


306 

GO0DPERCENT=.85 
307 


DISTRIBUTION ! 
FACTOR i 


198 
199 


134 


310 


BASE I 


200 


135 


311 


Dfl AREA 


201 

DDSBUSIZE 



-XGSEC (GROUP SECURITY) 



SIRRETURN (FROU GETSIR) 
DIRECTORY POINTER "A" 
DIRECTORY POINTER "B" 



136 
137 
138 

139-160 \ 

> SEE Directory 
161-182 / Pointer Area 



SYS. ACCT. INDEX BLOCK SIZEI 183 

1 

LDEV : DIRECTORY I 184 



PV DIRECTORY SIZE I 185 
1 

PRIVATE VOLUnf DIR. SIZE I 186 
1 

iiiiiiiiiiiiiiiiiiiiiiinn 187 
1 

iiiiiiiiimiiiiiiiiiiiim 188 

— i 

iiiiiiiiiiiiuiiiiiniiiin 189 

—i 

iiiiiiiiiiiiHiiiiiiniiin 190 

— i 

imiiiiiimiiiiiiiitiim 191 
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UORK AREA 
(SIZE OF LARGEST ENTRY) 



613 

DDSBUSIZE 
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Directory 

Directory Pointer Urea fDB or 061 0ST=gO(1O) SIR=8(10) 



Directory 



Directory Space Data Seqnent (DIRSDS3 



ldev | directory esse 

ROORESS Of PUCE IN BUFFER 



DIRECTORY PflOE IN BUFFER 



D6 ADDRESS OF 1st ELEPf NT 



STARTING ADDRESS OF BUFFER 
* VALID PAGES IN BUFFER 
Dl" 



ELEMENT SIZE 



• MOROS USED IN BLOCK 
BLOCK SIZE (SECTORS) 
BLOCK SIZE (WORDS) 



!tf« * ELEfttNTS/BLOCK 

l-l-l-l- 1 

IIPI TYIELEfINT SIZEIBLOCK SIZE 
'III (UORDS) | (SECTORS) 

l-l-l 1 

I NUHBER OF ELEHENTS 



NUHBER OF ACCESSORS 



ENTRY TOTAL 

• l-l-l-l ! 

0 1 P I TYIENTRY SIZEI BLOCK SIZE 
-l-l-l-l (UORDS) | (SECTORS) 

-l-l-l-l 1 

FATHER INDEX POINTER 



E I 
■—«--(- 
I 

1- 



139/161 0IRBASE1 ' 
140/162 DIR8ASEZ' 
141/163 CONTENTS 
142/164 LPNTR 
143/165 IOPNTR 
144/166 NUPWP.IID 

145/167 O-DIRTY FLAG, B S 8AD ELEHENT 

146/168 KSIZE NOTEi 

14Z/169 USED «* INDEXES AND 
ENTRIES 

148/170 BSIZE 

« INDEXES ONLY 

149/171 BUSIZE 
150/172 8F ACTOR 
161/173 HISCUD 

152/174 XCOUNT 
153/175 PCOUNT 
154/176 ETOTAL 
155/177 EMSCUD 

156/178 PINDEXP 
167/179 

158/180 PNAHE TY = O-FILE 

1 - GROUP 

2- ACCT 

3- USER 

4- VSD 

0- ENTRY BLOCK 

1 - INDEX BLOCK 
PURGE FLAG 



DST=21 (125) 
SIR'S 



159/181 
160/182 



I 
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DST = 21 ( 225 ) 






111111 
0123456789012345 




0 


I logical device! Bit nap 




1 


1 base sector address 


DS'BASE 


2 


| . 

I Ptr to last avail uord in buff 


DS' LAST 'UORD 


3 


| 

1 Ptr to first uord in buffer 


DS'FIRST'UDRD 


4 


| 

1 Size in sectors of directory 


DS'DIR'SIZE 


5 


|D|E|S|P| 

| 


DS' FLAGS 


6 


j First current sector in buff 

i 


DS'CUR'SECTOR 


7 

10 


I Disc address of current part 
I of bit nap in the buffer 


OS'ADDR 


11 


1 Size of buffer in uords 
| 


DS'SIZE 


12 


1 Next requested sector 


OS'REQ'SECTOR 


13 


| Last sector in bit nap 


DS'LAST'SECTOR 


14 


1 Systen saved pntr to last 


DS'SYS'LRST 


15 


1 Systen saved pntr to first 


OS'SYS'FIRST 


16 


1 Systen saved current sector 


DS'SYS'CUR 


17 


| 

1 Saved directory size 


DS'SYS'SIZE 


20 


1 LOEV that last error occurred 
| 


DS'ERROR'LDEV 


21 


1 Type of error that occurred 


DS'ERROR'TVPE 
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Directory 



This section of the bit nap 
DST is occupied by up to 3 
sectors oF bit nap. It is 
suapped in 3 sectors at a 
tine as needed. DS'FIRST'UQRO 
is updated to search for 
space in the bit nap. When 
it reaches DS'LRST'UORD for 
the second pass, the next 3 
sectors of bit nap uill be 
snapped in. 



Partial definitions: 

OS' LDEV = 
OS' DIRTY * 
DS'ERR'IH'PROG = 
DS'DIR , DISB8LE0= 
DS'PERn'0ISft8LE= 



DS'BflSEO. (0:8) 
DS' FLAGS. (0:1) 
DS'FLRGS.(1:1) 
DS'FLflGS.(2:1) 
DS'FLAGS.(3:1) 



Descriptions: 
DS'flDOR 

This is the address of the section of bit nap that is currently in the buf- 
fers. For example, this address uill usually be the sane as DS'BftSE. If ue 
need to page in no re sectors of bit nap than the first three, then this ad- 
dress uill be subsequently larger than DS'BASE. 

DS'BRSE 

This is the base address of the directory bit nap. If the directory is 
greater than 6112 sectors, then this address uill be 29 sectors less than the 
address found in the Cold Load Information table on disc. 

DS'CUR'SECTOR 

This is the current bit nap sector nunber of the first sector in the buffer 
area. Its value can range fron 1 to 30. This nunber Minus one added to 
DS'BRSE uill result in DS'RDDR. 

DS'DIR'DISHBLED 

If this bit is on, the directory allocation and deallocation is off and only 
a UARHSTRRT uill turn this bit off. The bit is turned on if an I/O error oc- 
curs on a directory bit nap sector or if he find data integrity problems with 
the bit nap, i.e. if ue attenpt to deallocate a sector that is already 
deallocated. 



Directory 



DS'DIR'SIZE 

This is the size (sectors) of the directory area. This size includes only 
the last 3 sectors of the bit nap. If the directory is greater than 6112 
sectors, then this size does not include the extra 29 sectors of bit nap. It 
can also be thought of as the nunber of bits in the bit nap. 

DS' DIRTY 

This bit is set if the bit nap sectors in the buffer have been nodified in 
any uay. Uhen nore sectors nust be brought into the buffers, or if ue suitch 
to a different donain (systen to PV, PV to systen) this bit is interrogated 
to deternine if the sectors presently in the buffers nust be first uritten to 
disc. 

DS' ERROR' LOEV 

The LDEV in uhich the last directory error occurred. 
OS' ERROR' TYPE 

This uord describes the type of directory bit nap error that occurred. Its 
legal values are: 

0 - No error 

1 - I/O error on a urite 

2 - I/O error on a read 

3 - Attesting to deallocate space that is already deallocated 

4 - Directory space nanagenent is already disabled 

DS'ERR'Ih" PROGRESS 

fl directory space nanagenent error is currently in progress. 
DS'FIRST'UQRO 

R DST relative pointer to the uord in the bit nap buffer that ue uill in- 
terrogate next when directory space is needed. Uhen the systen first cones 
up, this uord is aluays initialized to DS'HEADER+2 {i.e. to point to the 
first uord in the bit nap). On subsequent bit nap sector reads, it is set to 
DS' HERDER since subsequent sectors uill not have the 2 word overhead that ex- 
ists in the first sector of the bit nap. 

DS' FLAGS 

This uord contains nunerous flags. See individual descriptions. 
DS ' LAST' SECTOR 

This is the total nunber of active bit nap sector?. This nunber mil 
ranse fTMi 1 to 32. 
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Directory 



DS'LRST'UORO 

This is the current nunber of bit nap word in the buffer. It can range fron 
1 to Z577 ♦ DS'HEHDER. If there exists 3 full sectors in the buffer, 
then it uill have the value 7.600 « DS'HEHDER - 1 or X621. It is compared to 
DS'FIRST'UORD to determine if we have hit the end of the current buffer 
area. 

OS'PERtTOISABLE 

If this bit is set, then directory allocation/deallocating is permanently 
disabled. This bit should not be set. 

DS'REQ' SECTOR 

This is the next sector to begin reading in up to 3 bit nap sectors. It is 
updated by 2 or 3 and the read procedure uill bring in up to 3 sectors 
starting fron this sector. If this sector is set to be greater than 
DS'LflST'SECTOR, then it is reset to 1. After the sectors are read in, 
DS' CUR' SECTOR is set the DS'REQ' SECTOR. 

DS'SIZE 

This is the size in uords of the bit nap buffer area. It is aluays a mul- 
tiple of a sector (128 words). It Hill usually have the value of Z600. 
Legal values are 2200 , 7.400 and 2600. 

OS'SYS'LBST, DS'SYS'FIRST, DS'SYS'CUR & DS'SYS'SIZE 

The values of DS'LRST'UORO, DS'FIRST'UORD, DS'CUR'SECTOR and DS'SIZE uill 
be stored in these locations uhen the directory space nanagenent switches 
fron the systen directory to a private volune directory. Rnd, of course, 
when DSN switches back to systen donain, the above nentioned values are 
reinitialized uith these values. 
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Directory Structure 

INDEX BLOCK 



INDEX 
BLOCK 
PREFIX 



INDEX 
BLOCK 
ENTRY 



INDEX 
SLOCK 
ENTRY 



-> I- 



I INDEX PREFIX 



I INDEX PREFIX 



-> I- 



ENTRY 
ENTRY 



-> |- 



The Index Block prefix paints back to 
the previous higher level. The Index 
Block entries point to the entry blocks. 
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Directory 



Directory 



Directory Definitions 



Index Entry (6 Uords) 



>PflGE - snallest allocatable record ("phys.recd")-currently sector. 
>BL0CK - integral* of pages; contains contiguous indices or entries. 
>INDEX - pointer to entry block, containing nane of 1st entry. 
>ENTRY - information-containing "object" nay contain pointer to an 
index block. 

>P0INTER - 15-bit positive relative page nunber (relative to directory 
base). 

>DDS - directory data segnent. 

>ELEH£NT - a generic nane for index or entry. 



Index Block Prefix (10 Uords) 



0- FILE \ 

1 - GROUP | 3 bits 

2- flCCT |< 

3- USER / I 

4- VSET I 

I 

PURGE FLRG<- — I 
I I 



->| INDEX SIZE (UORDS) 
I 7 BITS 



I 



->l BLOCK SIZE (SECTORS) 
I 4 BITS 



.!;!;!---]- 

0 11 [F i T¥ i XoIZl 

i-i-i— -i- • 

1 | XCOUNT 

I - 
2 1 IPCOUNT 



INDEX oLuC" INFO . 



I- 1 

|1 NUMBER OF INDEX POINTERS 



-I 

1 2 NUMBER OF ACCESSORS* 
-I 



3| ETOTflL |3 ENTRY TOTALS 

l-l-l— -I 1 1 

EMSCUD 4|0|P| TY | EXSIZE IEBSIZEI4 ENTRY BLOCK INFO. 

I-I-I 1 1 1 

S| PINOEXP 1 5 INDEX POINTER OF FATHER 

I I 

61 16 \ 

I I I 

7| |7 | 

| PNAflE I >NBtlE OF FATHER 

10| IS I 

I I I 

111 19 / 

I I 

I I 

*7he count is incremented by each access that uses and relies 

upon a pointer to the index block, i.e., it is guaranteed not 
to be purged uhile the count is not = 0. 
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-I 

10 1st NAME OF ENTRY BLOCK 
I 

H 



IEPNTR 
IECOUNT 



|4 POINTER TO ENTRY BLOCK 
-I 

1 5 NUNBER OF ENTRIES IN e BLOCK 

-I 

Recount Entry (Z36 Uords) 



RGIPNTR 
AUIPNTR 



101 
I 

"I 



13 
-I 

14 RCCT. GROUP INDEX POINTER 
-I 

15 ACCT.USER INOEX POINTER 

| CAPABILITY 
17 
-I 
18 

I LOCAL ATTRIBUTES 
19 



131 

I 

141 
I 

151 



110 PASSUORD 



I" 
I 

112 



113 
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Directory 



Recount Entry (Cant. ) 



161 
I 

171 

I- 
20! 

I 

211 
I- 

22 
23 
24 
25 
26 
2? 
30 
31 
-32 



114 

115 
-I 
MS 

17 

18 

19 

20 

121 



DISC Fllf SPACE COUNT (SECTORS) 
DISC FILE SPACE LIBIT (SECTORS) 
CPU TIRE COUNT (SECONDS) 

cpu Tine unit (seconds) 



1 

1 22 

RCONTINECOUNT | CONNECT TIKE COUNT (BINUTES) 
1 23 



1 

1 24 

RCONTIBE LIBIT | CONNECT TIBE LIMIT (MNUTES) 



125 
-I 



I I I I I I 126 
l-l-l-l-l-l-l-l-l-l-i 
33|S|fl|/////| |27 
I 1 1 

34 | COBB FILE REC « ACCT | 28 
| 1 

35 1 COBB FILE REC » SYS 1 29 

| 1 



l-l-l-l-l 1- 



FLAG-S (SEE BE LOU) 

BAX.JOB PRIORITY 

coroiand file location of 
account udes 
connand file location of 
systen udes (SYS acct only) 



HARD CODED 
0 1 



I I 



1- 



l-l l-l 



I PI//I/////I R I R| A I A| U | U| L I LI X | X| S | S| 
■>ASECU| \ll\lllll\m IBCIBNY |BC|BNY 1RCIDNV IflCIBNY IBCIBNY |BC| 
|..|..|..|..|....|..| (.., l-l— -l-l 1-| 1-| 



PURGE flag 



If 1, systen level UOC's exist (only in "SYS" account) 
If 1, account level UOC's exist for account 
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Croup Entry (151 Uords) 




CROUP FILE INDEX POINTER 
PASSWORD 

DISC FILE SPBCE COUNT (SECTORS) 

OISC FILE SPBCE LIBIT (SECTORS) 

CPU TIBE COUNT (SECONDS) 

CPU TIBE LIBIT (SECONDS) 

CONNECT TIBE COUNT (BINUTES) 

CONNECT TIBE LIBIT (BINUTES) 

GROUP SECURITY (SEE BELOU) 
*P = PURGE FLAG 
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Directory 



Group Entry fCont.) 



27 
30 
31 
32 
33 
34 
35 
36 
37 
40 
41 
42 

I- 
431 

I- 
441 

I- 
«| 

I- 
461 

I- 
47| 

I- 
50| 



GCBPABILITY 

GLINKAGE 

GVSDIPHTR 



GflVsmnE 



123 GROUP CAPABILITY 

124 GROUP DIR. BASE LINKAGE 
-I 

125 GROUP VOL SET OEFN INDX 

-I 

126 HONE VOL SET NBBE 
-I 

127 
-I 

|2S (Definition's acct nane) 

129 
-I 

130 
-I 

131 

-I (Definition's group nane) 

|32 
-I 

1 33 
-I 

I34 
-I 

I35 

(Definition's vol set nane) 

36 
37 



C-SAVEFIPNTR 
GBOUNTREFCNTR 

0 



3S SAVE CELL FOR GFIPNTR 

39 GROUP BIND COUNTER 

40 GSPRRE 



I- 



1 



6 



GLINKRGE 

8 9 10 11 12 13 14 15 



IPV HVTABX 



Directory 



Group Entry (Cont. ) 



(0: 1 ) = 0; hVS is in Systen Donain 
(0:1) > 1; HVS it in Private Volune Donain 
(8:8) = 0: If not PV or Not Bound 
(8:8) <>0; If PV and Bound 

GROUP SECURITY BASK 
| — | — | — | — | — | — | — |. 



I P I///I R I R I R I R I R I A | A | A 
25| I///IRNYIAC |AL IGU |GL I ANY | AC |AL 
I — |— I— I— |— I—I— I— 1.-|— 

I U | L I L I L I L I L | X | X | X | X 
26IGL IANVIBC |AL IGU |GL |BNY|AC |AL IGU 
| — | — | — | — | — | — | — | — | — | — 



— | — | — | — | — | — 
R I A | U | U | U | U 
W IGL IANVIBC |BL |GU 



-1—1— I- . 
X I S | S | S | S | S 
GL IANVIBC |AL IGU |GL 

— I — I— I— I — I— 



File Entry (File PointerXS uords) 



-I 

10 FILE NNBE 

I 



FVTR8INX | 



FLABELADDR 



VOL TABLE INOX / FILE LABEL DISC 
ADDRESS 



I - Bad file label 
(0:1) = 0 - not defective 
= 1 - defective 
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Directory 



Directory 



ilwr atmbutts/C«ablU» 



01 10 use* Mine 

11 UNFtltt II 

2! 12 
31 13 

I I 

•I 14 CAPABILITY 

i IICSP I 

51 15 

! — — I 

61 6 LOCAL ATTRIBUTES 

! DIBITS I 

71 17 

| 1 

101 18 PSSSUORO 

111 UPASS 19 

121 HO 
131 111 

I I 

14| 112 HOrlE GROUP (BAY 3E HULL) 

151 UHGROUP 113 
161 114 
17| 115 

| I LOG CMT (» OF USERS LOGGED ON) 

201 ULOGCGUNT M6 HIT TO 1 FOR IIBNRGER.iYS SO 

| | THIS USER CBNNCT BE PURGED 

UH8XJ0BU 21|«P|UI 0 I JOBPRI |17 PBX.J38 PHI; »P=PURGE FLB6 

I | -I U=UOC EXIST FLS5 

22IC0TO1 FILE REC » 118 
Kcorotand Fill loc oF| 
I user udes) I 
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/ SBVE FILES 

FTLE-hCCISS ATTRIBUTES < ! 

\ NCN-5«RSait£ DEVICES" I 

MnmiNiMTloM I I 

N9K wwew ! I i I 

HETLGRK =CnHISTAA"C.« I I | 

/ S"S'£" "GA I I I ! i 

; I 5c:ou*t riGR I I I I I 

I I I -ACCOUNT LIBRN I I I I i 

USES II!! - GROUP LISRM I I M I 

i 1 1 I I DIAGNOSTICIAN | | | i | 

i I | | I I --SYS7EI1 SliPVSH I I I I I 
STTR I I I I I I I CREATE VOLS I I I I I 
I I I I I I I I USE VOLS I | I II 
\ I I I I I I I I USER LOGGING I I ! I 
I I I I I I I I I SYSTEn PROCESS HANDLING 
PR0GRB1MATIC SESSIONS 
I I ! I I I I I I I I I I M I 
l-|-l--l--!--i--l--l--l--l--l-l--l--!~l--l--l 
iSn!«1iBLiGLI5IiOPICVIuVILGISP!PS|Kfl!N!1|CSIMDISF| 
i„|..|..|..|..|.. i ..|..|-.|..|-|-|..,..|..|..| 

0 1 2 3 4 5 E 7 8 9 10 11 12 13 14 IS 

I — I — t — t — » — 1 — I — I — I — I — I — I — i — i — 1 — * — I 
i//l//l//l//i//l,'/i//lBS|:a|Pni//l//|asi/7lcs|PNI 
! — 1 — I — I — I — f — I — 1 — 1 — I — I — t --I — i — 1 — I — i 



ill I 

/ batch access -III I 

I interactive access 1 I I 

ACCESS i 5ri/:ie S ed node i I 

TO < 

GE.nESPL ! .iLltisie 'IMS -- - --'< 

RESOURCES! extra data sigrent 

\ procass handling 
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Volune Set Definition Entry 



Directory 

6VSIINKAGE 

0 1 2 3 4 5 6 7 ! 9 10 11 12 13 '4 15 



01 
11 
21 
31 



GVSWH1E 



VOUIflE 
ENTRY 0 

(S UORDS) I I- 
I 1210 



11TYIH12 
SIVOL C0UNTI4 



/ 61 
I 7| 
I 101 
111 



10 

11 V0LUI1E 

12 SET 

13 NflUE 
-I 

14 GVSIINKHGE 

15 GVSINFO 



I T | fl 1 
I I I 



NOT 
USED 



J1EHBER VOLUnE 
NSHE(1ST ENTRY 
IS nflSTER 
VOUME) 



VOUHE 
ENTRIES 
1 - 7 



\ 131 PSEUDO SUBTYPE 
| 

/ 1«l 
I . I 
I . 



I 

\57 



60 



63I 



14| n|10 GVSVOLFLRK 
1 

|11 GVSVOLINFO 
1 

HZ 

I . 



|4? 



T - TYPE 

0 = Vciune Set 3e?iriti:n 

1 = Vci-jne Set Class 
fl - ALLOCATING FLAG 

0 = not initially allocating (not 1st jser of set) 

1 = 1st user cf set allocating resources (transitional) 
HVTB8X - Bounted Voluie Table Index 

0 if volune set not logically nounted 

GVSINFO 

0 1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 



I- 

I VOLCNT 
I 

I 



NOT 
USED 



GVSVOLUHi 



641 


GVSVOLFIRGS 


(ITEI18ER VOLUHE FLAGS) 


651 


GVSVOLINFO 


(nEnSER VOLUnE INFO) 


1- 
661 


GVSDREFCNT 


(DEFN. SEF. CNTR.) 


1- 
671 




0 



148 

I 

149 
I 

150 Ml. VOL. 
I NflflE 
151 
I 

1 52 



1 53 
I 

I54 
I 

I55 SPARE 

I 



VOLCNT - Nunber of nenbers in set 
VStlfiSK - Bit nask of volune nenber usage 
Order is fron right to left 

i.e. , bit 15 it let nenber, bit 14 in 2nd ntnbar . ,. 

OVSVOLFLBGS 

0 1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 



n - Flenber nounted Flag 

0 = not nounted 

1 = nounted 

GVSVOLINFO 

0 1 2 3 4 5 6 7 ! 9 10 11 12 13 14 15 



TY = 0 VCLUBE SET DEFINITION 

= I VQLUdE CLASS 
nVTflBK: nOUNTEO VOUWE TABLE INDEX (IF IMUHTEO) 

vol count: no. of voushes 
vi1bsk: volute husk 
ii = 0 not (10unted 

= 1 hounteo 
ytb8x: volute table index 
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oi s: 


;iBBX 


=SEL0O SUBT'PE 





DISC PSEUDO-SUSTYPE = (Actual typt *16) * actual subtype. 
VTABX - Volune Table Index 



G.00.00 
4- 20 



Directory 



Volun. Sit Um. fntr. 



0|1: 



111111 
2:3|4:5:«IM:9»:1:2I3:4:S 



WCHflM 



GVC LINKAGE 
GVCINFO 



101 



wcwwnns 



131 

I- 

141 



161 

I- 

171 



20| 



221 

I- 
231 



0 VOLUIIE CLASS HflW 



VOUK CLASS IDENTIFICATION 
VOLUnt CLASS INFORItfrTION 
PARENT VOLUK SET DEFINITION 

ACCOUNT OF PARENT DEFINITION 



GROUP OF "BRENT DEFINITION 



VSNfW OF PARENT DEFINITION 



Directory 

6VCLIWKH&E 

0 1 ! 3 4 5 i 7 t 9 10 11 12 13 14 15 

I I 

I T I UllllllltlltlllimilltllllllHIIIIIIIItlllllllllllltl I 

I I 

T - TYPE 

1 * Volune Sit Definition 
0 * Volum Set Class 

t v c I N f ; 



S 6 



9 10 11 12 13 14 15 



NOT 

USED 



VCI1ASK 



I VOLCNT | 

I I 
I 



VOLCNT - Nunber oF nenbert in sit 

VCrlASK - Bit nnk of volum nenoer usige (VOLuTIE CLASS HASH) 
Ordt r it fron right to left 
i.e. bit 15 it 1st nenber, bit 14 it 2nd nenbtr ... 

Volune flatk Fonut 

- USED IN ITVTB8, PVUSER, FILE CONTROL 8 LOCK (FC8), 
VOLUtlE SET/CLASS DEFINITION. VOUWE SET VTR8. 

- s-eir P1ASK. 



I V7 I V6 I V5 I V4 I V3 I V2 I VI I VO I 



I I 



0: NOT H0UNTEO OA NON-HEHBER 



- V0LLH1E 0 (OUSTER) 

• VOLUnE 1 

■ voluhe 2 

■ VOLUflE 3 

■ VOLUHE 4 

• VOLUHE 5 

• voluhe 6 



- — VOLUHE 7 
10UNTEO OR flEflBER 
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Lock Resources 



CHAPTER 5 LOCK RESOURCES 



SIR* Allocation DST 253 



Sir's Ordered by Sir Nunber 



SIR ft 


RRNK 


CTD UOMC 

aiR Hrint 


1 


10 


i frori Denrr^ 
LUHU rKULCoo 


2 


335 


rorHF rnMTJfni 

inlnL LUninUL 


3 


91 




4 


92 


000 


5 


50 


□ oniric Tore ^TDiirTiiDF 


S 


60 


iUntUULlnlj JUtut 


7 


70 


Li 1 Ln \ K ito 


3 


SO 


oioicn ulKCL I UKT 


9 


90 


LDT^ 


10 


85 




11 


110 


itUKnut in uvtruii risen 


13 


130 




14 


140 




15 


27 


1MOT 


16 


5 


FHflVT 


17 


22 


LUMULK OtWltri 1 InOLt 


18 


180 


VOD 


19 


190 




20 


200 


MFI^QfiF rnTQi flPlF 

lltOontfC LHIHLUUUI. 


21 


210 


RIT 


22 


220 


imi HHP TQQI t 


23 


230 


ucirnnF nF^$or.F STff 

HtLLUnt ntoorlut Oiri 


24 


240 


liooUUi.nl lun inOLE 


25 


250 


LO rILLUlnlE. 


26 


260 


1 flfX.TKir. SIIFFFff 
LULrulrtu DUFTCn 




83 


PV HVTflB 


28 


280 


I1EHSSIR 


29 


290 


PV USER TABLE 


30 


300 


irtflGE 


31 


310 


KSfifl 


32 


320 


USER LOGGING 


33 


330 


DEBUG BREAKPOINT TABLE 


34 


340 


PCB 


35 


350 


SUB-QUEUE tlflPPING TRBLE 


36 


360 


CILOG 


37 


25 


FILE INTEGRITV 


38 


380 


RIK 


39 


390 


TAPE LABELS 


40 


87 


DEVICE CLflSS TABLE 


41 


400 


Reserved 


42 


401 


Cold Load SIR 


43 




1st JOB 


44 




2nd JOB 
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SIR Table Information 



The systen internal resource table is located in non-linked nenory (resident 
table). The SIR table is used to protect critical systen elenents against 
access by no re than one process, i.e., it provides a "iock out" nechanisn. 
Each critical systen resource (usually a table) is assigned a specific SIR 
nunber. Procedures are provided within HPE to lock (GETSIR) and unlock 
(RELSIR) the SIR. Processes attenpting to obtain a SIR that is not available 
are inpeded by the systen. The SIR table entries forn the head of a linked 
list in this case. If no re than one process becoties inpeded, uord 15 of the 
PCB entry is used to add the "new" process to the growing list. The Method 
of uninpeding the process depends on the SIR type. 

P, SIR does not respect process priority and operates in a FIFO nanner. fls 
processes becarie inpeded on behalf of a SIR the new entries are entered at 
the tail of the inpeded list. Uhen the current holder of the SIR releases 
it, on the first process in the list (pointed at by the head pointer) is 
uninpeded. The linked list head and all pointers are then updated and the 
neuly uninpeded process uill obtain the SIR. 



Lock Resources 



Sir's Ordered bv Ranking 



RANK 


SIR « 


SIR HRflE 


s 


16 


FHRVT 


10 


1 


LORD PROCESS 


22 


17 


LOADER SEGHENT TABLE 


25 


37 


FILE INTEGRITY 


27 


15 


JI1AT 


50 


5 


PROCESS TREE STRUCTURE 


60 


6 


SCHEDULING QUEUE 


70 


7 


CST ENTRIES 


30 


8 


SYSTEtl DIRECTORY 


83 


27 


PV flVTBB. 


85 


10 


LOT 


87 


40 


DEVICE CLflSS TABLE 


90 


9 


IPOT 


91 


3 


I0D 


92 


4 


ODD 


110 


11 


STORAGE IN OVERLAY AREA 


130 


13 


JPCNT 


140 


14 


JCUT 


180 


18 


VDD 


190 


19 


SPOOK 


200 


20 


BESSAGE CATALOG 


210 


21 


RIT 


220 


22 


VOLUHE TABLE 


230 


23 


UELCOUE BESSfiGE 


240 


24 


ASSOCIATION TABLE 


250 


25 


CS ALLOCATE 


260 


26 


LOGGING BUFFER 


280 


28 


tIEASSIR 


290 


29 


PV USER TABLE 


300 


30 


ItlAGE 


310 


31 


KSAB 


320 


32 


USER LOGGING 


330 


33 


DEBUG BREAKPOINT TABLE 


335 


2 


CACHE CONTROL 


340 


34 


PCB 


350 


35 


SUB-QUEUE HAPPING TABLE 


360 


36 


CILOG 


380 


38 


RIN 


390 


39 


TAPE LABELS 


400 


41 


Reserved 
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0 1 2 3 4 5 



SIR Entry Fomats 



7 8 9 10 11 12 13 14 15 



free 



. MH „I_. M _-|-|--|--I"I--IH--M--! 

0 lo 

1 

0 (1 (not locked) 
I 

0 |2 
I 

0 |3 
I 



PCB index of holder 
0 



SIR locked 



M (no inpeded processes 
-I 



\l 



PCB index of holder |0 SIR locked 

SIR QUEUE LENGTH 11 (impeded processes) 

1 

HERO OF MPEDED UST(PCB relative) |2 

TRIL OF I11PEDED LIST(PCB relative) ]3 



P = PINK 

PIN = PCB table entry nunber 

SIR QUEUE LENGTH- nunber of processes queued for this SIR 

The SIR table is indexed by SIR*, uith each SIR* corresponding to a unique, 
pre-assigned systen internal resource. Entry tO is not used. Inpeded lists 
are established by using the SIR table entry (2) as the head of the list and 
PCB(15) for elenents. PINs are aluays used as pointers, uith 0 indicating 
end of list. 
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File Systen 



CHAPTER 6 FILE SYSTEn 



This chapter descrioes the E1PE V file systen. The second section describes 
the basic concepts. The third section describes the table structures used. 



File Systen Overview 

I/O to files is done by reference to file nimbers, uhich are assigned by 
calling the FOPEN intrinsic. This establishes an initial "point of attach- 
nent", uhich nay be described as a connection between a progran (i.e., 
process) and that particular point in a particular file at which the next 
FRERD or FURITE would cause data to be transferred, A point of attachment is 
described by a control block, of uhich there are several different kinds 
(described later). Control blocks nay exist in the process's oun stack or in 
an extra data segnent assigned by the file systen. In order to find control 
blocks quickly, a pointer schene called vectors is used. H control block is 
uniquely described by a vector, uhich consists of two words with the first 
word containing a segnent nunber and the second uord containing a uord offset 
into the control table of the vector table entry uhich describes the location 
of the control block within that segnent. The entire assenbiage, consisting 
of eight overhead words, the vector table, and all of the control blocks to 
uhich it points, conprises the entire segnent; if in a stack, it occupies 
part of the PXFILE part of the PCBX. 

The point of attachnent is described by a "physical access control block", or 
PflCS, uhich will exist as a result of an FOPEN to any file (except *NULL). 
Any required I/O buffers are associated with the PRCB; refer to Section 2.1. 

fill FOPENs specifying "nulti-access" for all processes running under a single 
job use a single PRCB for references to a nulti-access file. Rlthough all 
these are attached to a single point in the file, the type of attachnent 
(i.e., fiOPTIONS) nay be different. So, each FOPEN specifying a nulti-access 
file establishes a "logical access control block", or LflCB, which contains 
the point-of-attachnent local values. The use of a single buffer (i.e., 
PRCB) ensures that references by various processes or against various FOPENs 
uithin one process are dealt with in strict sequential order. Note that 
references to a file by other jobs, or by other processes not specifying 
nulti-access, will be through other PRCBs, whose buffers Mill be read or 
written at the pleasure of the file systen; in order to ensure any sort of 
coherence to such shared references, the jobs nust use global RINS and FLOCK 
and FUN LOCK the file. IS7DIN, SSTDLIST, and spoolfiles are opened nulti- 
access autonatically. 

In the case of disc files, there is another kind of control block: the file 
control block (FCB). It contains copies of infornation read fron the file 
label, such as the end-of-file pointer, the extent nap, and the record and 
block structure. The EOF pointer is updated in the FCB as the file is urit- 
ten, and all changes nade to the FCB are posted to the file label uhen the 
file is closed. Rn FCB is shared by all jobs in the systen which reference 
the file. 
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File Systen 



This section gives a detailed discussion of the nain tables constructed and 
used by the file systen. The location and overall structure of each table is 
given, in addition to the table fornat and a discussion of each field in the 
table. Table indices at the right of the table are in octal. Index nanes 
apply to the entire uord; if in parentheses, the nanes are defined in the 
file systen listing but not explicitly used there. 



File Svstw Section of PCBK (PXFILE) 



The PXFILE area is a subsection of the PCBX. It is a contiguous, expandable 
and contractible block of storage that is Managed by the file systen prinari- 
ly for its oun use. Other subsystens, nanely CS and DS, also nake use of the 
PXFILE section. In doing so they nust confom to the conventions of the file 
systen. 

The overall structure of the PXFILE area is: 



CONTROL BLOCK 
TABLE 



ACTIVE FILE 
TRBLE 



(FIXED) 



(VARIABLE) 



(VRRIABLE) 



(VARIABLE) 



| QL-5 



File Systen 

The file nunber assigned by an FOPEN is an index into the Available File 
Table (RFT), a table of six-uord entries uhich is at the end of the PXFILE 
part of the PC9X. Two double words are vectors to the PRCB and (if it ex- 
ists) the LACB. 

AFT entries can also reside in a global AFT extra data segnent. If the file 
was opened Global AFT (specified in the AOPTIONS) and the progran is 
privileged, then the RFT is placed into this global RFT OST. Any accesses to 
the file are identical to local AFT's. Rll accesses to the file opened 
global nust be done fron privilege node code. The file systen intrinsics 
distinguish this file by a negative file nunber. Again, these files are 
identical in every other way except for where the RFT entry resides. 

Because control blocks are shared ariong processes, it is necessary to have a 
schene for coordinating access to then, fi control block is "locked" by a 
process uhich requires exclusive access to it for a tine. Other processes 
uhich attenpt to lock the block will find it already locked, and will be in- 
peded and queued. It nay also be necessary to lock an entire control block 
table so that a process can create or destroy a control block in it, or lock 
or unlock an existing control block in the table. 

Another table used by FOPEN is the File (lulti-Rccess Vector Table (FRflVT). 
This table exists in a systen extra data segnent and is used by all jobs and 
processes in the systen. Uhen a file is being FOPENed uith nulti-access 
specified, the FflRVT is searched; if the file is already open, the FrJRVT 
gives the PACB vector for the prior reference for each job. 



R bit in ROPTIONS specifies, when a file is opened, whether access is to be 
buffered or unbuffered. If unbuffered, data is transferred directly between 
the I/O device and the user's buffer (usually in his stack), uhich uill be 
frozen in nenory for the duration of the transfer. If buffered, the data is 
noved between the user's buffer and a file systen buffer to uhich the I/O is 
actually done. 

Buffers are associated uith the PACB, attached to it as an appendage. 
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File Systen 



The part labeled Overhead contains infornation that pertains to the 
entire section. It is addressed via the pointer at DL-3. 



PXFILE SIZE IN UOROS 


0 


PXFSIZE 




LUST DOPEH ERROR NO. 1 LAST COPEN ERROR NO. 


1 




- 

N 1 


2 






LAST DE RFT 


3 




SLRVE RFT HUHBER 


4 




LfiST KOPEN ERROR NUNBER I LAST FOPEN ERROR NUMBER 


5 






AFT SIZE IN IIORDS 


6 


PXBFTSIZE 




CS TRACE FILE INFO 


7 
S 


(PXCTRINFO) 




LAST RESPONDING NO-UAIT I/O AFT ENTRY NUNBER 


9 


PXFLEFTOFF 


- " 

1S T USE? '"OB"^ r 0H TII 0 l BLQ r K TRBLE DST NUilBER 

„:r:.™r:.r.:.:-.r--:™"™::-:L:r:.:.:.'.:.'.::.. 


10 


PXFCBT1 


2ND USER (NOBUF) CONTROL BLOCK TRBLE DST MUHBER 


11 


(PXFCBT2) 


3RD USER (NOBUF) CONTROL BLOCK TABLE DST NUMBER 


12 


(PXFCBT3) 


- 

4TH USER (NOBUF) CONTROL BLOCK TABLE DST NUMBER 


13 


(PXFCBT4) 




5TH USER (NOBUF) CONTROL BLOCK TRBLE DST NUMBER 
- 


14 


(PXFC8T5) 


6TH USER (NOBUF) CONTROL BLOCK TABLE DST NUM8ER 


15 


(PXFCBT6) 


- 

7TH USER (NOBUF) CONTROL BLOCK TABLE DST NUMBER 


16 


(PXFCBT7) 




8TH USER (NOBUF) CONTROL BLOCK TRBLE DST NUMBER 


17 


(PXFCBT8) 



Partial uord field identifiers 


are: 






PXfDOPEN 


■ PXFILE(l) 


(0:8)*, 


last OOPEN 


error code 


PXFCOPEN 


= PXFIIEO) 


(8:8)», 


last COPEN 


error code 


PXFNOCB 


= PXFILE(2) 


(0:1)*, 


no CB's in 


PXFILE CBT? 


PXFKOPEN 


= PXFILE(5) 


(0:5)*, 


last KOPEN 


error code 


PXFFOPEN 


* PXFILE(5) 


(8:8)*, 


last FOPEN 


error code 
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File System 



Discussion; 

PXFfiFTSIZE This 18 the size (in words) of the Active file Table (AFT). 

The size is in words to simplify calculating the size of 
the available block. 

PXFCBT1-8 These are the OST numbers of the user (NOBUF) control block 

tables. A DST nunber of 0 indicates that no data segment is 
allocated. 

PXFCOPEN This contains the last COPEN error nuHber. Hot used by the 

file system. 

PXFCTRINFO This contains information pertinent to the CS tract file. 

Hot used by the file system 

PXFDOPEN This contains the last DOPEN error nunber. Hot used by the 

file system. 

PXFDSIHFO Reserved for DS. Not used by the file systen. 

PXFFOPEN This contains the last FQPEN error nunber. If it is zero 

then the last FOPEH successfully conpleted; otherwise the 
last FOPEH uas unsuccessful and the nunber is the file sys- 
ten error number. 

PXFKOPEN This contains the last KQPEN error nunber. KSflfl is partly 

embedded in the file systen, and an FOPEN failure on a KSfifl 
file can be caused by a failure to open either the key file 
or the data file. This error number is used in conjunction 
uith PXFFOPEN to determine uhich file caused the KSAfl open 
failure. This error nunber is not used by the file systen. 

PXFLEFTOFF This is the AFT entry nunber of the last file/line that 

conpleted a nouait I/O; if zero then no nouait I/O has been 
conpleted. This cell is Maintained solely by and for the 
IOUAIT intrinsic. 

PXFH0CB This bit signifies that control blocks are not to be 

created in the PXFILE control block table. This bit is set 
by the NOCB paraneter to the CREATE intrinsic or the :RUH 
connand. This feature pernits the user to have as much 
stack space as possible; otherwise the file systen Hill 
take several hundred uords of stack for the PXFILE control 
block table. 

PXFSIZE This is the size (in uords) of the conplete PXFILE area. It 

is the sun of the overhead block, the control block table, 
the active file table and the available block. 
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PKFILE Control Block Table fPXFCBT) 

Addressing within a PXFILE control block table is sonewhat nore complicated 
than addressing an extra data segnent CBT since the table does not begin at 
DB+O. As a result all pointers uithin the table are table relative; the 
starting address of the table mist be added to a pointer to generate a final 
DB-relative address. This addressing convention is consistently applied to 
all control block tables. 

Uhen the control block table is expanded, space is taken fron the AVAILABLE 
area. If no space is available then the PXFILE area is expanded and the ac- 
quired space is added to the AVAILABLE area. 

Available Block 

The part labeled Available is used to provide space uhen the Control Block 
Table or the Active File Table is expanded. These two tables grou touards 
each other, and uhen nore space is needed it is simply taken fron the 
Available Block. 

Uhen the Available area is exhausted, the PXFILE area is expanded, the AFT is 
relocated and the new space is added to the Available Block. 

Currently the PXFILE area is only expanded; it is never contracted. 
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Hctive File Table (AFT) 

The part labeled Active File Table contains information used by the file sys- 
ten (or CS, DS, etc.) to grossly characterize the file access and, nost 
inportantly, to give the location of the control blocks. 

The overall structure of the AFT is: 



File Systen 

The structure of * file systen AFT entry is: 
0 12 3 4 5 
ENTRY TVPE I N I 

PHYSICAL ACB DST NUHBER 



I 0 
--I 



I I 



I 1 



(FIXED, 6 UORDS) 



DL-9 

(FIXED) 
DL-S 



I 

t ■ 



i — 



PHYSICAL ACB EHTRY ADDRESS 

LOGICAL ACB DST NUHBER 
LOGICAL ACB ENTRY ADDRESS 
N0-UAIT I/O IOQX 



AFTP8CBDST 
| 2 AFTPACBENTRY 

3 RFTLACBDST 

4 AFTLHCBEHTRY 
AFTIOQX 



-I 

I 4 
-t 

i 5 



The entry format depends on the entry type; the file systen uses entry type 
0. 

The following partial word field identifiers are used: 



uhere N = PXFHFTSIZE/6. 

The length of the AFT is specified by PXFfiFTSIZE. Unused entries are all 
zeros. Uhen the table is full it is expanded by taking space fron the 
Available block. 

The AFT is negatively indexed by file nuMber: the entry at DL-9 corresponds 
to file nunber 1, the entry at DL-1S corresponds to file nunber 2, etc. 

The structure of the global AFT DST, described in Section 2 is as follows: 



AFTTYPE 
AFTNULL 



Discussion: 
AFTIOQX 



= AFT. (0:4)11, 
= AFT.(4:1)#, 



entry type 
MULL file 



I I 

ENTRY 0, NOT USED | 
I 

I 



I Dfl + 6 
I 
I 



-I 

I DB+(N*6) 
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This is the 100 index of the pending nouait I/O (if any). 
This is applicable if the file uas opened uith the NOURIT 
option specified. Also, CS and DS have the sane capability 
and use this cell in a consistent manner. This is because 
the IOUAIT intrinsic services the file systen as well as CS 
and DS, and is the principal user of this cell. If the IO0X 
is negative, then one of two possibilities exist. If the 
file is a message file, then file IOQX is the accessor's re- 
ply port. If the file is a standard RPE file, then a read 
uas done to a nonexistent extent and this is simply a stub 
inserted by the file system. 

This is the DST that the Logical ACB (LflCB) if it exists. 
This is applicable if the file uas opened with the multi- 
access option specified. 

This is the word offset into the control block table of the 
LACB vector table entry, aoplicable if the file uas opened 
with the nulti-access option specified. 

This bit signifies that the file is t>iULL and that there a^e 
no control blocks. 
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RFTPfiCBDST This is the DST that contains the Physical RCB (PBCB). R 

PBCB exists For all files except MULL. 

RFTPBCBENTRY This is the uord offset into the control block table of the 
PBCB vector table entry. This uiil be nonzero for all files 
except «NULL. 

BFTTYPE This is the BFT entry type nunber. Rt present the follouing 

entry types are defined: 

0 - file systen 

1 - renote file 

2 - DS (nouait I/O disalloued) 

3 - DS (nouait I/O alloued) 

4 - CS 

5 - CS 

6 - KSRF1 

8 - Message File 



Renote file BFT entry: 

0 1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 



H--I--I--I- 
I FSTYPE 



UNUSED 
LINE NUtlBER 



REMOTE FILE NUMBER 



| PENDING FCLOSE DISPOSITION FROM FOPEN 

I- - 

I UNUSED 



|nR| 0 
-I 

I 1 
-I 
I 2 



I 3 
-I 

I 4 
-I 

I 5 



BFT 0 

FSTVPE - This value uill be 1 for renote files. 



FIR 
BFT 1 
BFT 2 
RFT 3 

BFT 5 



- Set if the file uas opened nulti-access. 

- Local line nunber of renote file. 

- File nunber of the renote file. 

- Pending disposition of the file. Set uhen file uas FOPEN' d and 

Mill possibly be used as the FCLOSE disposition. 

- No Hait I/O Queue Index. 
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CS Line entry: 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
-l-l-l-l-l-l-l-l 



I FYPE 



| Ul UIIDI B| UNUSED 
LOGICAL DEVICE NUMBER 



I 0 
-I 
I 1 



1 



VECTOR TO MULTIPLE 100 INDICES 



II R| DIflLI 



I 3 



- I 



I 



IOQX ( CIO only ) 



I 5 



BFT 0 
FTYPE 

U 
ID 
B 

BFT 1 
BFT 2 
BFT 3 
TR 



R 

DHL 



BFT 4 
BFT 5 



This value Hill be 4 or 5. fl 5 signifies that the line 
has an autodialer attached. 

- The line has been opened uith no uaiting on I/O requests. 

- Line is a milttpoint control or 3270 station. 

- Line uas opened uith buffering. 

- Logical device nunber of the line. 

- Vector to Multiple IOQ indices. 

- Bit 0 on signifies tracing enabled. Bit 1 on signifies 
trace all. 

- On if line is currently connectcw. 

- Signifies that this CS device is an SCCP device. 

- 0 = Dial on urite, answer on read. 

1 = Bnsuer on urite, dial on read. 

2 = flluays dial. 

3 = Never dial. 

- DST nunber of the line's nisc data segnent. 

- If <> 0. then it is the systen D6 address of a single request 100 
entry. IOURIT uses this uord to pass the IO0 index of the con- 
pleted request for this BFT to CSIOURIT. 



File Systen 

DS BFT entry: 
0 1 2 3 4 5 6 7 8 S 10 11 12 13 14 15 



I- 



-I--I--I--M--I- 



I FSTYPE ! CI Ml PI R| DS ERROR NUMBER 

I " 

OBTR SEGMENT NUMBER 



I 0 
-I 
I 1 



I DSDCB INDEX 



PREVIOUS RFT POINTER 
IOQX 



I 5 



RFT 0 

FSTYPE - This 



ielc uill have the value 2 or 3. 



C 
M 
P 
R 

RFT 1 
BFT 2 
RFT 3 
RFT 4 
RFT 5 



On if 0S3PEN called by CXDSLINE or REMOTE' HELLO. 
On if naster PTOP RFT. 
On if PTOP related. 
• On if renote nain process. 
DS data segnent table pointer. 
DSDSCB Index - DS data segnent control block index. 
Logical device nunber. 
Preceding DS open BFT Pointer. 
- IOQX - Sane as described above. 
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File Control Block Table (CBTBB) 



fl file control block table can be located in tuo places: (a) as a subpart of 
the PXFILE area, as discussed in Section 3.1.2; or (b) in a data segnent. 
Rlthough putting control block tables in PXFILE has the advantage of provid- 
ing rapid access, it detracts fron the space for the user's stack; so the 
larger control blocks (or optionally, all control blocks) are put into extra 
data segments. On the other hand, referencing extra data segments nay result 
in an absence trap, uhich is slou. Extra data segnent control block tables 
are of three kinds: expandable, nonexpandable, and shared FCB. 
Nonexpandable CBT's are used for a single PRCB uith buffers, i.e., uhere the 
control block is large or where the control block can't be local to a single 
process (for mjlti-access) . Expandable (or NOBUF) CBT's are used for snail 
control blocks ,as LBCB's, PFICB' s uith no buffers, and FCB's uhich are local 
to a single process, fi list of the expandable CBT's associated uith a 
process is kept in the overhead area of PXFILE (cf. Section 3.1.1). Uhen a 
snail control block is needed, these CBT's are checked in order to see if one 
of then has roon. Shared FCB CBT's are sinilar to expandable CBT's except 
that they belong to the systen rather than to a single process; the systen 
keeps a list of DST's uhich it has assigned for this purpose. 

The overall structure of a control block table is: 



| (FIXEO, 8 UOROS) 
I 

-i 



CONTROL BLOCK 
BRER 



(VARIABLE) 



(VARIABLE ) 
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File System 


File Systen 


Overhead 






CBTPIN This is the PIN nunber of the process that has the control 
block locked. 


The part labeled Overhead contain! infomation pertaining to the entire 
table. 

0 12 6 7 15 


CBTSIZE This is the size in uords of the table. It is in- 
itialized uhen the table is created and changed uhen the 
table is expanded. At present a table is never contrac- 
ted, even though this is possible. 

CBTTYPE This field is the type of the control block table. 
Possible values are: 


I TABLE SIZE IN UORDS 


I 0 CBTSIZE 


i DST NUnSER CONTAINING TABLE 


— -I 

I 1 CBTDSTX 


0 - stack [PXFILE] 

1 - HOBUF (expandable) 

2 - Systen shared FCB 

3 - Buffered (Contains a single PBCB) 

C8TVTSIZE This is the size, in uords, of the vector table area in the 
control block table. It does not reflect the nunber of 


I TYPE | VECTOR TABLE SIZE IN UOROS 


1 

I 2 




LOCK PIN 


— -I 

I 3 CBTPIN 


I L I 




— -I 

I 4 CBTCONTROL 


! IMPEDED OUEUE HERD 


1 

I 5 (CBTOUEUE) 


entries used or unused. 


I IBPEDED QUEUE TRIL 


I 6 


NOTE: RI1 PIN'S are kept as the uord offset into the PCB table and as the 
actual PIN nunber. 




UNUSED 


— -I 
I ? 




Other identifiers used: 






C8TTVPE = CBTBB(2).(0:2) Control block table type 
C8TVTSIZE = CBTAB(2).(2:14) Vector table size 
CBTLOCKBIT* CBTCONTROL. (0:1) Lock bit 




Discussion: 








CBTDSTX This is the DST nunber of the data segnent that con- 
tains the control block table. If the table is con- 
tained in a stack, i.e. in the PXFILE area, then this is 
the DST nunber of the stack and not 0. 




CBTLOCKBIT If the entire control block table is locked, then this bit 
is set. No locking count is kept since control blocks are 
locked only once fron FCREflTECB and FDELETECB uhen control 
blocks are added to and deleted fron the table. The proce- 
dure LOCK'CB does not lock the control block because it runs 
PSEUDODISBBLED during the critical tines. 




CBTQUEUE This is the inpeded queue for the table and has the sane 
fortiat as the inpeded queue for a control block in the 
table. There is no second inpeded queue because that 
facility is used exclusively for BREAK requests against 
the PACB for »STDIN/«STDLIST. 
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File Systen 


Vector Table 






The following partial uord identifiers are used: 


The part labeled Vector Table contains infortiation used to locate and lock 
or unlock control blocks in the control block table. 


VT'LOCK'BIT 3 VT'CONTROL. (0:1 ) 
VT'BREAK'BIT = VT'CONTROL.!!:!) 
VT'COUNT = VT'CONTROL. £2:6) 


The overall structure of the vector table is: 




Discussion: 




1 

ENTRY 0 | 

i 

- 1 

1 
1 

i 
1 
1 

1 

I 


(FIXED, S UORDS) 


VT'AOR Control block address is the table relative address of the 
control block associated uith the vector table entry. 
It is a uord displacenent fron the beginning of the control 
block table. 

VT'BREAK'BIT This bit signifies that ue are in the niddle of break node. 

This is used for the PACB of fSTDIN/KTDLIST fron a terainal 
session only. 

VT'LOCK'BIT This bit is set whenever the control block is locked. 




ENTRY N 

1 


(FIXED) 


VT'COUNT This is the count of the nunber of tines that the control 
block has been locked by the process identified in VT'PIN. 
If it is zero, then the control block is not locked. 


uhere N = (CBTVTSIZE/8)-! . 

An unused vector table entry uill have zeros in all the uords of the 
entry, fl used vector table entry uill have a nonzero value in the first 
uord of the entry {the control block address is necessarily nonzero). 

The general structure of a vector table entry is: 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 


VT'PIH Contains the PIN of the process which has exclusive ac- 
cess to the control block. Other processes at- 
tending to access the block uill be inpeded and 

queued. 

VT'QUEUE The high priority inpeded queue is a double uord of PINs 
that are the head and tail of the inpeded queue of processes 
Haiting for access to the control block. Processes are 
inpeded and uninpeded by the file systen using the nomal 


I ,r ' CONTROL BLOCK ADDRESS 


0 VT'flDR 


nechanisHs available under flPE . 


I L| B| COUNT 


1 UNUSED 


1 VT'CONTROL 


VT'SRVEDQUEUE The low priority inpeded queue is a double word of PINs 
and has the sane fornat as VTQUEUE. The only tine this uord 


i LOCK PIN 


2 VT'PIN 


is used is uhen the control block is in BREAK node, 
which can only happen to an flCB corresponding to 
$STDIN/$STDLIST. It is used to save the current 
VTQUEUE uhen the control block goes into BREAK node and to 


i HIGH PRIORITY HEAD PIN 


3 VT'QHERD 


1 HIGH PRIORITY TRIL PIN 


4 VT'QTAIL 


restore VT'QUEUE uhen the control block goes back into 
non-BRERK node. 


1 LOU PRIORITY HERD PIN 


5 VT'SRVEDHERD 


NOTE: fill PIN's ars stored as offsets uithin the PCB table and not as actual 
PIN nunbers. 


1 LOU PRIORITY TAIL PIN 


6 VT'SRVEDTAIL 


1 UNUSED 


7 
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File Systen 


Control Block Area 

The part labeled CONTROL BLOCK AREA contains the control blocks used by the 
file systen. 

To facilitate storage Management, all control blocks have the sawe 
overall structure: 


Uhen space is returned it becones a neu garbage control block. To reduce 
f ragnentation the neu garbage control block is combined uith either of the 
tuo neighboring control blocks if they are of type garbage. 

If space is requested and no garbage control block is large enough to contain 
the neu control block then the control block area and control block table are 
expanded by a sufficient anount. If expansion is not possible, sorte other 
control block table nust be used. 


0 12 15 
| TYPE i SIZE 1 0 CBDESCRIP 


Access Control Block (BCB) 


; 1 1 

i DATA I 

I I " 




Virtually every file systen intrinsic constructs an RCB as its first action. 
Uhen using the tiulti~access option, each accessor shares a single PRCB. 
However each accessor is pernitted to vieu the shared file in a slightly dif- 
ferent manner than the other accessors. For exatiple, one accessor nay access 
the file in a read-only node uhile the other accessors nay access the file in 
a read-urite node. To do this, each accessor Must, during his access, have a 
slightly different flCB. 


uhers N = Size-1 . 

Partial word field identifiers are: 

CBTYPE = CB.(0:2)«, control block type number. 
CBSIZE - CB.(2:14)t; control block size 




The PRCB holds information that is global to all accessors of the file. The 
LflCB holds infornation that is local to each accessor of the file. Rt the 
beginning of a particular access, an RCB is constructed by calling LOC'flCB, 
which copies infornation fron both the LflCB and the PflCB. fit the end of the 
access, the RC8 is released by calling UNLOC'flCB; this updates the PflCB and 
LflCB fron the flCB since sone of the fields nay have been nodified due to the 
access. This schene nearly elininates EXCHflHGEDB's to access the various data 
segments. 


Discussion: 






CBDESCRIP This is the first uord of a control block; the fortiat is 
connon for all control blocks. 




CBSIZE This is the size (in words) of the control block, 
includes the descriptor uord. 


The size 




CBTYPE This is the type nuiiber of the control block, 
four types of control blocks: 


There are 




0 - Garbage 1 - FCB 2 - PACB 3 - LflCB 






Lthen a control block table is created the initial control block area is con- 
pletely allocated to a single control block of type garbage. When space is 
requested for a neu control block the control block area is scanned (using a 
first fit algorithri) for a garbage control block that is as large as the size 
requested. The space for the neu control block is taken fron this garbage 
control block and the space renaining becomes the neu garbage control block 
size. 
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File Systen 


Loqical Access Control Block (LRCB) 




IflCBCTL See flCBCTL. 


All LACBs have the sane structure: 

0 1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 




LflCBERROR See RCBERRQR. 
LRC3FNUR See RCBFNUfl.. 
LRCBFOPTIONS See RC8FGPTIQNS. 
LRCBrlODE See ACBtlODE. 
LFfCBNfiJIEl-3 See HCBNfME. 

LflCBPflCB This is the DST and vector table entry for the 
Physical RCB (PflCB) for the file, 
file. 

LRCBRSIZE See RCBRSIZE. 

LRCBSIZE This is the size, in words, of the LflCB. fill LftCBs are 
eighteen (decinal) uords long. 


| 3 1 COMPLETE LBCB SIZE 


0 


: FILE NUMBER 


1 


; FILE NAME - 1ST CHAR. I FILE NAME - 2ND CHAR. 


2 


I FILE NAME - 3RD CHRR. I FILE NAME - 4TH CHAR. 


3 


I FILE NAME - 5TH CHRR. I FILE NAME - 6TH CHAR. 


4 


; FILE NAME - 7TH CHAR. I FILE NAME - 8TH CHAR. 


5 


i FOPTIONS 


6 


I AOPTIONS 


7 


LftCBSTflTE See BCBLSTRTE. 


| RECORD SIZE IN "BYTES 


10 


LftCBSTOPCHftR See flCBSTOPCHHR. 


I BLOCK SIZE IN UORDS 


11 


LflCBTLOG See ACBTLQG. 


! SPARE 


12 




i CARRIAGE CONTROL CODE 


13 




I IEOFIPG I LN 1ST I FX |TC |TB 186 ICBRIOB 1 EOF T I EOF M I 


14 




| c| 1 TEI ICI 0 1 1 TERMINAL STOP CHARACTER 


15 




ERROR CODE 


16 




! LAST I/O TRANSMISSION LOG I 17 




Partial uord field identifiers are: 






LACBSIZE = LAC8.(2:H)», size in uords 
LACBSTOPCHAR = WCB(2). (0:8)#, terainal stop character 






Discussion: 






LACBROPTIDNS See BCBAOPTIONS. 






LACBBSIZE See RCBBSIZE. 
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Physical Access Control Slock (PRC8) 
The overall structure of the PAC8 is: 



BUFFERING 



(FIXED) 



(VfiRfflBLEi 



The buffering extension is optional; it is present if and only if the file 
is accessed uith buffering. There are thus tuo possible formats for an 
flCB: 

1 . Ho buffers; the buffering, extension is not present. 

2. PRCS buffers; the buffering extension is present and the buf- 
fers in in the buffering extension. 

If Multiple PftCB buffers exist, there Mill be a buffering extension for 
each, innediately preceding the buffer. The basic PRCB (or NOBLIF PflCB) is 
copied into the the flCB as uords 0 through Z63; an flCB "extension" is then 
generated in uords 7.64 - Z67. The resulting flCB thus has the follouing 
fomat: 
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2S I 
I 

V | 

I- 
2! | 

29 

30 

31 

32 

33 

34 

35 

36 

37 I 
I- 

38 | 
I- 



File Systen 



I 32 



TOTAL HUflBER OF LBCB'S 



I 33 
-I 
I 34 



IBK i 



DEVICE TVPE 



I LAST LOGICAL I/O STATUS 



LOGICAL DEVICE NUMBER 



PF iHITi 



36 



CURRENT BUFFER j TAPE DISPLACE I NO. BUFFERS | 37 



CURRENT RECORD UORD INDEX 



-I 



I 40 



BUFFER SIZE 
VIRTUAL LOGICAL DEVICE NO. 



NUHBER OF INPUT LACB'S 



I 41 
-I 

I 42 
-I 

I 43 
-I 

I 44 



FILE DISPOSITION 



ACCESS BIT RAP 



I 



BLOCKING FACTOR 



39 I S | 11 | g I R | 0 I 



I RE| RUjABRI NE| SEOFSI EOFS 



40 I SPOOLED DEVICE TVPE I 



I- 



SPOOLEO DEVICE RECORD SIZE 



41 



44 

I 

45 i 



SPG01EO DEVICE FOPTIONS 



SPOOLED DEVICE AOPTIONS 



IDD OR 0D0 INDEX 



NO-UBIT DISK ADDRESS 



47 I 



NO-UAIT LOGICAL DEVICE 



4S I 

I- 
50 I 



P1P2 USED BY FDEVICECONTROl 



UNUSED 

UNUSED 
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0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
2 I COMPLETE ACB SIZE 



FILE NRME - 1ST CHAR. 



FILE NUMBER 
FILE NAflE - 2ND CHAR. 



FILE NBtlE - 3RD CHAR. | FILE NRnE - 4TH CHAR. 
FILE NAHE - 5TH CHAR. | FILE HAtlE - 6TH CHAR. 



FILE NAflE - 7TH CHAR. | FILE NAME - 8TH CHAR. 
FOPTIONS 



AOPTIONS 
Record size in bytes 



BLOCK SIZE IN UORDS 
UNUSED 



CARRIAGE CONTROL CODE 
IEOFIPG |LN 1ST |FK |TC |TB 186 ICBRID8 I EOF T I EOF 11 



I TEI IC| 0 | | TERfllNRL STOP CHARACTER 
ERROR CODE 
LAST I/O TRANSMISSION LOG 



FILE POINTER 



CURRENT VARIABLE BLOCK NUMBER 



RECORD TRANSFER COUNT 



BLOCK TRANSFER COUNT 



HIGHEST BLOCK NUMBER STARTED 
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File Systen 



The above uords, 0-7.63, are physically located in the PAC8 of the file. 
Below, uords X64-X67, are used by file systen intrinsics- and are placed 
onto the stack by the procedure LOC'ACB when locking the flCB. 
Therefore, the buffering extension, if pres- ent, uill innedlately fol- 
lou uord X63 of the actual ACB in the Control Block Table of the file. 



DST RELATIVE OFFSET TO PACB 



DST RELATIVE OFFSET TO LACB 



DST RELATIVE OFFSET TO ACB IN THE STACK 



STACK RELATIVE OFFSET TO 09 



The following identifiers are used uhen referring to an ACB: 



(AC8SIZE) 

ACBFNUM 

RCBNRRE 

AC8NAI1E1 

ACBHAME2 

ACBFOPTIONS = 

ACBAOPTIONS = 

ACBRSIZE 

ACBBSIZE 

Spare = 

ACBCTL 

ACBLSTATE 

BCBEOF 

ACBLPCTL 

ACBPRGECTL 

BCBLINECTL 

ACBSTREAM 

BCBFKEVS 

RCBXHITCRLF = 

flCBTBLOCK 

ACBBINBRYIO = 

ACBCARRIBGE = 

(ACBDEFBLOCK) = 

ACBREADCODE = 

ACBREROTYPE = 

ACBREHDBODE = 

ACBHODU 

PCBHODE 

BCBCIROVERFL0U= 
SCBSETflOOE 
BCSTBPEERRGR = 
ACBISHIECRLF = 
PCSgiHESCE 



ACB.(2:14)#, 

BCB(t). (8:8)1, 

ACB(2)», 

ACB0BL(1)#, 

ACBD8L(2)«, 

BCB(6)», 

ACB(7)», 

ACB(8)«, 

ACB(9)», 

ACB(IO)*, 

ACB(11)«, 

BC802)*, 

ACBLSTATE. (1:1)8, 

ACBLSTATE. (2:2)*, 

ACBLSTATE. (2:1 )tt, 

ACBLSTATE. (3:1)*, 

AC8LSTBTE.(4:1)», 

ACBLSTATE. (5:1)*, 

ACBLSTATE. (6:1)*, 

ACBLSTATE. (7:1)*, 

ACBLSTATE. (8:1)*, 

ACBLSTATE. (9:1)*, 

RCBLSTATE.(10:1)», 

RCBLSTATE.(11:4)«, 

ACBLSTATE. (11:2)*, 

ACBLSTATE. (13:2)*; 

ACB(13)», 

BCBflODU.(0:8W, 

BCBnODU.(0:1)*, 

ACBM0DW.(4:4]*, 

SC8MBDW.i'4:1)«, 

HConuJU. (5:1 id, 

BCBnODU.(6:1)», 

ACEMCIU.rS:!;*, 



size in uords 
file nunber 
file nane 

file nane - first half 
file nane - second half 
FOPTIONS 
AOPTIONS 

record size (bytes) 
block size (uords) 
Unused 

carriage control uord 
local state flags 
end of file sensed 
page and line control 
page control 
line control 
strean I/O 

restore function keys 
transnit CR,LF to user 
disable block node 
8-bit terninal transfers 
carriage control flag 
default blocking 
input EOF check 
input EOF type 
input EOF node 
node word 
node setting 
Signifies CIR overflow 
FSETflODE bits 
report recovered tane pr^ 
inhibit tenunal CR/LF 
critical output venFy 
ten»i"3l stop character 
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RCBERROR 


= RCB(14)tt, 


error code 


Spare 


= RCB(46)tt, Unused 


flCBTLOG 


= RCB(15)tt, 


last I/O transmission log 


RCBNOURITLDEV = RCB(47)8, Nouait logical device 


flCBFPTR 


= flCBDBLCOS)*, 


current record nunber 


nrnni no 
HLbKl Yc 


- HlBubH^jH, USefl t>y rUtVlLtlUKIKUL 


RCBBLK 


= RCB0BL(O9)8, 


current variable block 


RCBP1 




RCBRTFRCT 


= ACBDBL(10)#, 


logical record TFR count 


ACBP2 


= RCB(49)8; " " 


fiCBBTFRCT 


= RC8DBL(11)tt, 


block transfer count 






fiCBHIBLK 


= flC8DBL(12)tt, 


highest block started 






RCBFCBV 


= RC8DBL(13)ti, 


FCB Vector table entry 


Discussion: 




ACBShtNT 


= RC8(28)8, 


It of LRCBs 






RCBSTRTU 


= RCB(29)#, 


access class, status, etc. 


HLBHBUK I KtHU 


This flag is used to abort a broken teminal re-read. Ine 


RCBBRERK 


= RCBSTRTU. (1:1)8, 


break (SSTDIN/LIST only) 




flag is set via tne hbuki paraneter to ruNOKtHK. ir tne 


RCBDTYPE 


= RCBSTRTU. (2:6)8, 


device type 




£1 K . ; A +l _ _ aeon QTUftTur unr-n iM ■ ■ i 1 1 kn .kn w^+^A 

flag is set tnen tne KtHU rtNuinu Message mil oe aoortefl 


RCBRCCCL 


= RCBSTRTU. (2:3)8, 


device access class 




along uith the re- read. This feature is needed to hand- 


RCBSUBCL 


= flCBSTHTU. (5:3)*, 


device sub-class 




le +in a QDrQk^ .ODn&T b+r pj+iii-finn 

ie tne D'^t^1^. . . .hbuk i , eic. siTuaiion. 


RCBSTRTUS 


= RCBSTRTU. (8:8)8, 


last logical I/O status 






RCBQSTRTUS 


= fiCBSTRTU.(8:5)8, 


qualifying status part 


aroarrri 


This is tne access class part or tne flevice type nun- 


RC8GSTATUS 


= RCBSTRTU. (13:3)8, 


general status part 




ber. The following are legal values: 


RCBOADDR 


= RCB (30)8, 


Ldev nunber of file 




. . . 
0 - direct (e.g. disc) 


RCBBUFX 


= flCB(31)8> 


buffer data & nisc. flags 




RCBPRIV 


= fiT8BUFX.(0:1)8, 


privileged access only 




1 - serial input (e.g. card reader) 


HC8HIT 


= flCBBUFX.(1:1)#, 


buffer hit flag 




2 - parallel input/output (e.g. teminal) 


RCBCURRBUF 


= RCBBUFX. (4:4)8, 


current buffer nor. 




3 - serial input /out put (e.g. nagnetic tape) 


RCBNUflBUFS 


= RCBBUFX. (12:4)8, 


nunber of buffers less 1 




4 - serial output (e.g. line printer) 


HCBBUFUSED 


= flCB(32)8, 


used block uord count 






RCBBUFSIZE 


= flCB(33)8, 


buffer size (words) 


HlBHlLtio 


This is the access bit nap for the file. The Following are 


fiCBSPVDEV 


= AC8(34)*f, 


spooled virtual device 




the bit definitions of this eight-bit field: 


ftCBFtlflVTX 


= flCB( 35 )«, 


FHBVT index 






RCBSHCHTIK 


= P.CB(36)8, 


Nunber of input LRCB's 




(0:1) - unused 


RCBDNTD 


= RCB(37)8, 


type &, disposition 




(1:1) - unused 


RCBDNTYPE 


= PCBDNTO. (0:3)t4, 


nane type for dir. search 




(2:1) - read 


flCBDISP 


= RCBDNTD. (8:8)8, 


file disposition 




(3:1) - append 


BCBHHLD 


= RCB(38)8, 


access nask & LDEV 




(4:1) - write 


RCBRCCESS 


= RCBRI1LD. (0:8)8, 


access nask 




(5:1 ) - lock 


RCBBLKFRCT 


= RCBflllLD. (8:8)8, 


Blocking factor of file 




(6:1) - execute 


RCBGSTU 


= RCB(39)#, 


spool control flags 




t / : i } save 


flCBSPOO 1 FD 


= RCBGSTU. (0:1)8, 


spooled device flag 




This access security is dete mined by the RCClhelk in- 


RCBSPOOUO 


= RCBGSTU. (0:2)8, 


spooled IN/OUT 




ACBSPSQ 


= RCBGSTU. (2:2)8, 


squeeze flags 




trinsic and enforced by the file systen. 


RCBSPSQZ 


= RCBGSTU. (2:1)8, 


file squeezed 






RCBSPRSQ 


= RCBGSTU. (3: 1)8, 


request to squeeze 


HldHUr I 1UNS 


This is the HOrlluNi in effect for tnis file access. 


RCBSPDSQ 


= RCBGSTU.(4:1)8, 


squeeze just done 




This bit controls full eight bit transfers on the 2644 page 


RCBNOfJAITEOF 


= RCBGSTU. (8: 1)8, 


EOF advanced? 


P.CBBINRRYIO 


RCBNOUfilTtlDDE = RCBGSTU. (9: 1 )#, 


last I/O: 0=read, 1=urite 




node teminal. It is adjusted by FCONTR0LE26) and 


RCBRBORTRERC 


= RCBGSTU. (10:1)8, 


abort broken re-read? 




FC0NTR0L(27). 


RC8NEUEOF 


= fiCBGSTU. (11:1)8, 


EOF advanced - tape file 






RCBSflVEEOFS 


= RCBGSTU. (12:2)8, 


for saving RCBEOFS 


RCBBLK 


This is the block nuttber of the current variable record for- 


RCBEOFS 


= RCBGSTU. (14:2)8, 


EOF flags - :E0D/: 




nat block. Rpplicabie if the record fornat is 


flCBSPTYRC 


= RCB (40)8, 


spooled dev type/recsize 




variable. 


HCBSPTYPE 


= ACBSPTYRC. (0:6)8, 


spooled dev type 






fiCBSPREC 


= flCBSPTYRC. (6:10)N, 


spooled dev rec size 


RCBBLKFRCT 


This is the blocking factor for the file. It is the nun- 


HLtiiHrUFl 


= ACB(41)8, 


spooled dev FOPTIONS 




ber of records in a block. Legal values range fron 1 to 


RCBSPROPT 


= ACS (42)8, 


spooled dev RGPTIONS 




255. 


RC8SPXDDX 


= RCB(43)8, 


IDD/ODD index 






RCBNDURITDfl 


= P.CBDBL(22)8, 


Nowait disc address 
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File Systen 




RCBBRERK 


This is the break node flag. It is applicable if the RCB 


flCBOTYPE 


... 

This is the device typfi nunber of the file. 1 fie 




is for ISTDIN or tSTDLIST. If set it neans that the 




following are legal values (octal): 




BREAK key has been hit and that the CI should have high 








priority access to tht 


RCB. The flag will be cleared 




0 - noving head disc 




when a RESUME or ABORT 


is issued. 




1 - fixed head disc 










7 - foreign disc 


RCBBSIZE 


This is the block size 


in words, of the file. 




10 - card reader 










11 - paper tape reader 


HCBBTFRCT 


This is the total nunber of blocks transferred to and fron 




20 - teminal 




the file. The initial value is OD. 




24 - card reader/interpreter/punch 










26 - SSLC 


HCBBUFUSED 


This is the uord index, relative to the base of the 




27 - progrannable controller 




block, for the selected record uithin the block. This is 




30 - nagnetic tape 




applicable if the file access is buffered. 




31 - serial disc 










40 - line printer 


RCBCflRRIRGE 


This bit signifies that the file has carriage control. It 




41 - card punch 




is the sane as 


the carriage control bit in 




42 - paper tape punch 




ACBFOPTIONS if the file is spooled. If not spooled, the 




- LHLtunM aw plotter 




bit is zero, and IOMOVE will pass the FURITE carriage 




1*} - LHLLUriH bOy plotter 




control paraneter directly to the driver rather than 




45 - CRLCOriP 700 plotter 




enbeddinq*t as the first character of the output record. 












RCBEOF 


This bit is set when EOF has been sensed. 


RCBCTL 


This is the CONTROL 


paraneter fron the last FURITE. 




1 his is tne type or tur aetectea on »o i uin^A } , \ nis 




This value is pertinent if the file was opened with car- 


HL.BfcUrS 




riage control. 






field consists of two bits: 


RCBCURRBUF 


This is the buffer nunber (O-relative) containing the nost 




[y.lj - super colon ii.e. tur ror »iiyin)tj 




recent!" referenced 


record. Bppiicable if the file access 




(1:11 - regular colon (i.e. tUr tor *ilU!MJ 




is buffered. 
















nppiicdoie ror nuiii access xa 9o\u±n\A/ ur\±y. 


RCBDHDDR 


This is the loqical device nunber of the file. For a disc 








file this is the 


logical device nunber of the first 


RCBEftROR 


This is the error nunber for the file. It is used by all 




extent. 




intrinsics except FOPEN. When an error is detected the er- 










ror nunber is placed in this cell. The error nutiber ie 


RCBOEFB LOCK 


This bit siqnifies that the file is to be accessed with 




cleared at the beginning of each callable intrinsic except 




default blocking. 


The bit is initialized fron the 




rcntuK ^Mnicn reads It } . 




FOPEN stateword STRTE. 


It does not need to be in the RCB; 








it is Mentioned here only to signify that the bit is effec- 


AC3FCB 


This is the FCB vector for the file. Applicable only to 




tively used due to 


the way RCBLSTRTE is initialized 




disc files. 




frori STRTE. 














HCBFKEYS 


This bit controls the definition of the f1 and f2 


flCBDISP 


This is the file 


close disposition derived fron the 




function keys on the 2644 page node teminal; it is ad- 




FOPEN call. The only 


way this can be specified is via a 




justed by FC0NTR0LO2) and FC0NTR0L(33). (Obsolete function) 




file equation. The 


legal values are the sane as those 








for FCLOSE. RCBDNTYPE 


This is the file reference 


RCBFNUR 


File nunber, range fron 1 to 255. Used nostly for 




fornat type nunber anc 


is derived fron the FOPEN call. The 




calling routines that access things such as labels by file 




following are legal values: 




nunber. 




0 - full nane 




RCBFOPTIONS 


This is the FOPTIONS in effect for this file access. 




1 - account nane 


absent 








2 - qroup and account nane absent 


flCBFPTR 


This is the sequential access record pointer; it con- 




3 - null narte 






tains the next sequential record nunber. The initial 










value is OD. This value is used only by the FRERD, FURITE 




This information is needed by FRENRflE. 




and FUPDRTE intrinsics. However the value is 
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Maintained by 
intrinsic*. 



file System 



cfata transferring file system 



This is the entry index into 
tor table ( FHRVT ) . This i 
is multi-access. 



the file nulti-access vec- 
: valid if the file access 



ACflLPCTL 
ACBLSTBTE 



These are Miscellaneous state flags. These are 
"global" in nature in that they are the sane for all ac- 
cessory in a multi-access environment. The con- 
stituent bits are described individually. 

This is the general part of the last I/O status for the 
file. The following are the legal values: 

0 - pending 

1 - successful 

2 - end of file 

3 - unusual condition 

4 - irrecoverable error 

This is the highest block number for which an an- 
ticipatory read has been issued, and is applicable if the 
file access is buffered- The initial value is -ID. 

This is the buffer hit flag. If set it indicates that the 
last read or Hrite request was serviced uithout any physical 
I/O required. This flag is used only for performance 
rteasurenent. The code which nanipulates it is optional to 
the file system, and is controlled by compiler toggle X3. 

This bit controls the termination of lines written to the 
terminal. If not set then each line is terminated with a CR 
and LF; if set then no line termination characters are 
used. This bit is valid if the file is a terminal file; it 
is adjusted by FSETMODE. 

This is the line control bit. If not set then each line 
is post-spaced; if set then each line is prespaced. 
This bit is used by line printers and terminals only. 
It is adjusted by FC0NTRGL(1 ) and FURITE uith the ap- 
propriate carriage control. 



This are the line and 
described separately. 



page control bits, which are 



These are miscellaneous state flags. They are "local" in 
nature in that they may be different For each acces- 
sor in a multi-access environnent. Bits (9:6) are initial- 
ized from the stateuord local variable called STBTE in 
FQPEK; the ten remaining bits are initialized individually. 
The constituent bits are described individually. 
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HC8RSIZE 
ACBRTFRCT 

RCBSflVEEOFS 

fiCBSHCNT 

flCBSHCNTIN 

AC8SHCATS 
RCBSIZE 

ACBSPROPT 
ACBSPFGPT 
fiCBSPOOLED 
RCBSPOOLIO 



flCBSPTYRC 



File System 



This field controls the input EOF checking type. It is 01 
for JOBs, 10 for SESSIQHs, and 00 for DATA. 

This is the file's record size in positive bytes. 

This is the total number of records transferred to and from 
the file. The initial value is 00. 

This Field is used to save the contents of RCBEOFS 
during BREAK node processing. 

This is the total number of LRCBs that exist for this 
PBC8. Valid if the file access is nulti-access. 

This is the total number of input-only IflCBs that exist for 
this PRCB. Valid if the file access is 

multi-access. 

This is the total LflCB and total input-only LflCB 
counts, each of which is described separately. 

This is the size, in words, of the RCB. The complete 
size (including buffers) nay be calculated fron the DST size 
containing the ABC. It does not include the buffering ex- 
tension, if present. 

This is the ROPTIONS for the spooled device. 
Applicable if the file access is to a spooled device. 

This is the FOPTIONS for the spooled device. 
Applicable if the file access is to a spooled device. 

This is the spooled device flag. If set then the file ac- 
cess is to a spooled device. 

This field is a combination of the spooled device flag and 
the input/output mode of the spooled device. Legal values 
are: 

00 - not spooled 

01 - illegal 

10 - input spooling 

11 - output spooling 

This is the record size, in bytes, of the spooled 

device. Applicable if the file access is to a spooled 
device. 

This is the device type (fron the LDT) of the spooled 

device. Applicable if the file access is to a spooled 
device. 

This cell contains the spooled device type and record 
size, which are described separately. 
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File System 
RCBflOOE 
RCBNAflE 
fiCBNEUEOF 



ACBNOURITflODE 



RCBNUflBUFS 
ACBPAGECTL 



These are miscellaneous node flags. The constituent bits 
are described individually. 

This is the local file name. The name is eight bytes in 
length with trailing blanks added. 

This flag when set indicates that a new tape nark 
should be written before the tape is rewound or 
backspaced. Applicable only to magnetic tape files. 

This bit is used to save the value of the local EOF ad- 
vanced flag MEUEOF in IOflOVE betueen the I/O initiation and 
I/O completion calls. This flag is applicable if the 
file is accessed in nouait I/O mode. 

This cell is used to save the I/O mode betueen nouait I/D 
initiation and completion calls. If the bit is set then the 
last I/O request was a write; otherwise it was a read. 
This cell is pertinent if the file is accessed in 
nouait I/O mode. 

This is the number of buffers, less one, used for the file 
access. Applicable if the file access is buffered. 

This is the page control bit. If not set then a page is 
assumed to consist of 60 lines (auto page eject); if set 
then a page is assumed to consist of 66 lines (no auto page 
eject). This is used primarily for line printers but 
is also valid for terminals; these are the only devices for 
which this is valid. This bit is adjusted by 
FCONTRQLO) and FURITE uith the appropriate carriage 
control. 

This flag when set indicates that the file is 
privileged in that it has a negative file code; the user 
must be in privileged node to access it. 

This is the qualifying part of the last I/O status for the 
file. The values are unique for each general status 
part. See I/O System IMS for all legal values. 

This bit controls critical output verification. If set, 
buffered output is guaranteed to have been written to the 
device when control is returned to the user. This bit is 
adjusted by FSETMODE. 

This field consists of the input EOF checking type and 
node, and is used to generate the P1 parameter to 
HTTHCHIO. These fields are described individually. 

This field controls the input EOF checking node. It is 00 
for reading ISTDIN, 01 for reading SSTDINX, and 10 for the 
command interpreter. 
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File System 
ACBSPVDEV 

RCBSPXODK 



This i 
device, 
device. 



s the logical device nunber of the spooled 
Applicable if the file access is to a spooled 



spoolfile. 
a spooled 



This is the index into the IDD or ODD For ; 
Applicable if the file access is to either 
device or a spoolfile. 



This is the last I/O status for the file. It cones fron 
the I/O status part of the IOCB returned by RTTACHIO. 
Not all flTTACHIO calls update this cell. 

This is the record termination character used for ter- 
minal reads. This character can be chanqed via 
FC0KTROL(25). 

This bit signifies inter-block garbage for disc files. If 
set, the block size is a multiple of 128 uords and there- 
fore there is no garbage data between blocks. This 
fact is used to improve multi record I/O by napping 
the request into as feu RTTRCHIOs as possible. 

This is the sub-class part of the device type number. The 
sub-class is unique for each access class. The follow- 
ing are the legal sub-class values for each device 



- direct 

0 - rioving head disc 

1 - fixed head disc 
7 - foreign disc 

• serial input 

0 - card reader 

1 - paper tape reader 
■ parallel input/output 

0 - terminal 

4 - card reader/punch 

5 - SSLC 

7 - programmable controller 
serial input/output 
0 - magnetic tape 
7 - serial disc 
' serial output 



line printer 
card punch 
paper tape punch 

■ CHLCOHP 500 plotter 

■ CRLCOOP 600 plotter 
CftLCOnP 700 plotter 
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flCBTRPEERROR 


This bit controls the reporting of recovered nagnetic 
errors. IF not set the recovered errors are not 
reported to the user; if set then recovered errors are 
reported to the user by returning CCL and error nunber 39. 
Valid if the file is a nagnetic tape file. This bit is 


If present, the PflCB buffering extension contains froti one to sixteen 
block buffers each having the following forriat: 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 




adjusted by FSETflODE. 

This bit controls block node transfers on the 2644 page node 
terninal. This bit is adjusted by FCQNTRQL(28) and 






IOfl ENTRY INDEX i 0 BLKIOQX 


BCBTBLOCK 




BLK LDEV NUI1BER | | 1 U| R| D| Uj n| p| 1 BLKFLfiGU 




FC0HTR0LC29). 

This is the last I/O transnission log for the file. It con- 
es fron the I/O transnission log part of the IOCB return- 
ed by HTTflCHIO. Not all RTTACHIO calls update this cell. 




IOCB - STATUS ! 2 BLKLSTRT 


flCBTLDG 




IOCS - TRANSMISSION LOG I 3 BLKTLOG 








| 4 BLKBLOCK 


RCBVDRDDR 


This is the volune table index for the file. 
Applicable if the file is a disc file. 






BLOCK HUflBER 1 

I 5 


RCBXtllTCRLF 


This bit controls CR and LF insertion into the user 
buffer on the 2644 page node terninal. This bit is ad- 
justed by FC0NTR0L(3O) and FC0NTR0L(31 ). 




j 6 BLKDflDDR 
BLOCK SECTOR ADDRESS ! 

I ? 








| 8 BLKEKTBRSE 
SLOCK EXTENT BASE I 

I 9 








BLOCK EXTENT SIZE I 10 BLKEXTSIZE 








UNUSED I 11 










| 12 BLKBUFFER 










BUFFER I 






Other identifiers used: 








BLKFLfiGU = BLK(1)«, Flag and LDEV word 
BLK LDEV = BLKFLfiGU. (0:8)#, block logical device nunber 
BLKFLBGS = BLKFLfiGU. (0: 8)tt, block I/O flags 
BLKUNfiLLOCEXT = BLKFLfiGU. (10: 1 ) , Block fron unalloc. extent 
BLKREVERSE = BLKFLfiGU. (11:1 J, FREflDBflCKHRRD (not used ) 
BLKDQNTUflIT = BLKFLfiGU. (12:1 ), I/O status not checked 
BLKIOOUT = BLKFLfiGU. (13:1 J**. last I/O uas urite? 
BLKDIRTY = BLKFLRGU. (14: 1 )ft, buffer nodified? 
BLKIOPEND = BLKFLfiGU. (15:1 )1t, I/O in progress? 
BLKIOC0HP - BLKFLfiGU. (14:2)8,1/0 conplete - not dirty 
BLKIOCB = BLKDBL(1)tt, IOCB 
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Discussion: 
BLKBLOCK 

B LK3UFFER 
BLKDHODR 


This is the block nunber of the data contained in the 
buffer, fl value of -1D indicates that the buffer is 
enpty. 

This is the actual file systen buffer space. Each buffer is 
exactly one file block in size. 

This is the block's logical device and sector nunber. 


BLKLST8T 

BLKTLOG 
BLKREVERSE 


The I/O status part of the IOCB consists of the PCB nun- 
ber and the error code for the coapleted I/O 
request. 

The transnission log part of the IOCB is the nunber of 
words or bytes transferred by the the I/O request. 

This bit would indicate that He are reading back- wards fron 
a tape. However, currently FRERDBRCK- UfiRDS can only be 
perforned unbuffered. 


BLKDIRTY 
BLKBONTUBIT 


This flag is set if the contents of the buffer has been 
nodified. Uhen the block buffer is re-used this flag is 
checked to see if the block needs to be written to the 
device. 

This bit will be on if the I/O was already coripleted via 
"DOKT ' UflIT" but the status has net been checked yet. Check 
the status before using the block in the buffer. 


BLKUNfiLLOtEXT 


This bit signifies that the block uas "read" fron an unallo- 
cated extent. Actually, the buffer uas sinply cleared with 
fill characters. Therefore, if a urite is attested to the 
block residing in this buffer, it nust pass through FCDNVBLK 
to allocate the extent first. 


BLKEXTBHSE 


This is the sector address of the extent base in which the 
block resides. This is used for disc caching. 








BLKEXTSIZE 


The size, in sectors, of the extent in which the block 
resides. This is used for disc caching. 








3LKF Lnuo 


These are the niscsilar.ecus flags associated with the 
block, which are described separately. 








BLKIOCB 


This is the IOCB returned by the I/O systen uhen the 
block I/O has coripleted. On a blocked I/O request this is 
obtained fron the RTTflCHIO call; on an unblocked I/O request 
this is obtained fron UAITFORIO. 








8LKI0COHP 


This is the buffer nodified flag (BLKDIRTY) and the I/O in 
progress flag (BLKIOPEND), which are described 
separately. This field is usually interrogated to see if 
it contains the value 2, uhich neans that the buffer has 
been nodified but not yet written to the device. 








8LKI00UT 


This is the node of the I/O operation for the block. It 
is set by a write and cleared by a read. 








BLKIOPEND 


This is the I/O in progress flag. It is set if the I/O is 
pending; it is cleared when the I/O has coripleted. 








BLKIOQX 


This is the 100 index of the unblocked I/O request for the 
block. It is used as the argunent to URITFORIO, uhich en- 
sures the coripletion of the I/O request. 








BLK LDEV 


This is the logical device nunber of the block. (Valid only 
for disc files. ) 
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File Control Block (FC61 

The FC8 coordinates access to a file on a sharable device, At present the 
only sharable device is a disc, so only disc files have FCBs. 

The information contained in an FCB is derived fron the file label. The FCB 
is used to hold this infornation, rather than the file label, since it can be 
accessed nore quickly. 

There are two strategies to choose fron in deciding where to place the FCB. 
If the file has been opened exclusive and no other process could possible 
share this file, then the FCB is placed into the PXFILE area (or in a m\ir 
expandable CBT if it uon't fit in the PXFILE area or if the progran is run 
uith NOCB). If the file could possible be shared, then the FCB is aluays 
placed in a shared control block table. The nutiber of a data segnent con- 
taining a list of shared file systen data segnents is kept in systen global 
location 1076 octal. The size of the FCB depends on the naxinun nunber of 
extents specified at FOPEN; there are 44 (octal) uords plus tuo per extent. 
There mil be at least one extent, since the file label aluays exists in the 
first extent. The FC8 extent nap is in.tems of logical device and sector 
nuiiber. The extent nap in the file label is in terns of volune rather than 
logical device; the nap is converted by VTR801DEV uhen the label is read, and 
converted back by LDEVTOVTAB uhen the label is written to disc. 

The FCB has the follouing fornat: 



7 8 12 13 14 15 

COMPLETE FCB SIZE 



1 I 

I- 

2 I 



3 I 

I- 



SPflRE 
FOPTIONS 
DEVICE SPECIFICATION 



I 2 FCBFOP- 



-I 



4 | PSEV. LOCKI DEV. TYPE I C I 

5 I 

| 

6 I 
I- 

7 I 
I- 

8 I 
I 

9 I C| 
I 

10 I 
I 

11 I 



IOEVICE SUBTYPE 



NO. OPENS FOR OUTPUT 
NO. OPENS FOR ANY NODE 
RIN NUMBER 
EXCLUSIVE STATUS 

I WTRBX | vnasK 



FILE UNIT 



HONS 
3 FCBOEVICE 

4 

-I 

I 5 
-I 

I 6 
-I 

I 7 FCBRIN 
-I 

I 10 FCBEXC- 
-i STRT 

I 11 FCBPVINFO 
-I 

I 12 FCBFLIM 
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LOGICAL DEVICE NUIIBER i 

LAST EXTENT SECTOR NUMBER 



Other identifiers used: 



FCBSIZE 

FC8LKST 

FC8DTYPE 

FCBCRUNCH 

FCBSUBTYPE 

FCBOCNTOUT 

FCBOCNT 

FCBCLASSFLG 

FCBMVTABX 

FCBVMASK 

FCBLBLEOF 

FCBLBL 

FCBBLKFBCT 

FCBSECTPBLK 

FC8SECT0FF 

FC8DISP 

FCBNUhEXTS 

FCBOCNT IN 

FCBLABEL 

FCBLDEV 



= FCB. (2:14)0, 
= FCB(4). (0:2)0, 
= FCB(4). (2:6)0, 
= FCB(4). (8:1)11, 
= FCB(4). (12:4)11, 
= FCR(5). (0:8)0, 
' FCB(5). (8:8)0, 
= FCB(9). (0:1)0, 

• FCB(9). (4:4)0, 

• FCB(9). (8:8)0, 

• FCB(16). (0:8)0, 
= FCB(16).(8:8)tl, 

• FCB(18). (0:8)0, 
■ FCB(18). (8:8)0, 
■■ FCB(19). (0:8)0, 
■■ FCB09). (8:3)0, 

■■ FCB09). (11:5)0, 
' FCB(21). (8:8)0, 
' FCBDBL(18)0, 

• FCB(36). (0:8)0, 



size in uords 
previous lock state 
device type 

pending crunch disposition 

device subtype 

no. accessors - output 

no. accessors 

PV class flag 

Mounted volune table index 

Volune flask 

no. labels uritten 

no. labels available 

blocking factor 

sectors per block 

sector offset to data 

pending disposition 

no. extents less 1 

no. accessors - input 

label LDEV and sector 

label LDEV 



FC8RC80ST This is the DST of the DCS that uas created at the sane 

tine as the FCB. This is used in conjunction uith 
FCBNEUFC8DST uhen relocating the FCB. 

FCBRCBV This is the vector table entry of the HCB that uas 

created at the sane tine as the FCB. This is used in con- 
junction uith FCBNEUFCBV uhen relocating the FCB. 



It is eight 



This is the account natie of the file, 
bytes in length uith trailing blanks added. 

This is the blocking factor of the file. It is the nun- 
ber of logical records in a physical block. Legal values 
range fron 1 to 255. 

This specifies the device on which the file resides. If 
it is positive then it represents a logical device rubber; 
if negative it represents a (negative) "device class irde*. 

COO. 00 

5- 39 



UNUSED 



I 14 
-I 
I 15 



15 I 



END OF DATA POINTER 



I 16 FCBEOF 



16 I NO. USER LR8ELS URITTEN I NO. USER LABELS RVSIL. | 20 
I j 

17 ( EXTENT SIZE IN SECTORS | 21 



18 I 



BLOCKING FACTOR 



SECTORS PER BLOCK 



22 

19 SECTOR OFFSET TO DATA | DISP I NO. EXTENTS - 1 i 23 



LAST EXTENT SIZE IN SECTORS 



I 24 



NO. OPENS INPUT NODE 



FCBUSESL8L 
FCBEXTSIZE 



FCBLAST- 
EXTSIZE 



CROUP NAME - 1ST CHAR. | GROUP NAME - 2ND CHAR. | 26 
GROUP NAME - 3RD CHAR. I GROUP NAME - 4TH CHAR. I 27 



GROUP NAME - 5TH CHAR. | GROUP NAME - 6TH CHAR. | 30 
CROUP NAME - 7TH CHAR. I GROUP NAME - 8TH CHAR. | 31 



ACCT NAME - 1ST CHAR. | ACCT NAME - 2ND CHAR. | 32 
ACCT NAME - 3RD CHAR. | ACCT NAME - 4TH CHAR. ! 33 



ACCT NAME - 5TH CHAR. 



ACCT NAME - 6TH CHAR. I 34 
ACCT NAME - 7TH CHAR. I ACCT NAME - 8TH CHAR. | 35 



START OF FILE BLOCK NUMBER 



i 36 FCBSTBRT 



CURRENT NUMBER OF DATA SLOCKS IN THE FILE 



! 40 

I 

I 41 



NUMBER OF OPEN AHD CLOSE RECORDS (MESSAGE FILE) I 



LOGICAL DEVICE NUMBER I 

FIRST EXTENT SECTOR NUMBER 



I 43 
-I 
I 44 

i 

I 45 



FC8NUM- 
OPENCLSREC 
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FC8DISP 



FCBENO 
FCBEOF 



FCBFOPTICNS 
FCBSN 



This is the pending FCLOSE disposition for the file. 
Legal values are: 

0 - no change 

1 - save pernanent 

2 - save tenporary and reuind 

3 - save tenporary but do not reuind 

4 - release 

7 - invalid file (file label access error) 

This bit governs if space uill be returned beyond the EOF 
upon the last FCLOSE of the file. 

0 - no change 

1 - return space beyond EOF 

This is the device type nunber of the first extent of the 
file. See ACBDTYPE for a list of legal values. 

Block nunber of the file's EOF, relative to FCBSTBRT. 

This is the end-of-file pointer for the file. It is a 
double integer representing the nunber of records in the 
file. It can also be viewed as the record nunber of the 
next record past EOF. 

This is the exclusive status of the file access. If -1 then 
the file is being accessed exclusively; otherwise it is the 
nunber of seni-exclusive accessors. 

This is the extent nap of the file. The nunber of ex- 
tents is specified by FC8NUMEXTS; a OD extent 
descriptor indicates that the extent has not been 
allocated. 

This is the extent size, in sectors, of the file. All ex- 
tents in the file except possibly the last have this size. 
This is a logical value, and legal values range fron 1 to 
sectors. This restricts the nsxinun file size to 
2097120 sectors (268,431,360 uords). 

This is the end-of-space pointer for the file. It is s 
double word integer representing the naxinun nunber of 
records (fixed length record fornat) or blocks (un- 
defined or variable length record format) in the file. 

This is the FOPTIOHS in effect for the file. 

This is the group nane of the file. It is eight bytes lsnq 



V-is locicai pes 



ano sector r.jnonr of the 
ss the *'irst extent descript. 



FCB LfiSTEXT SIZE 



FCBLDEV 
FCBLKST 



File Systen 



This is the size, in sectors, of the last extent in the 
file. If the file has one extent then this is the sane as 
FCBEXTSIZE; otherwise this value nay be different fron 
FCBEXTSIZE. This is the size of the last physical extent 
for the file; it is not the size of the last allocated 
-extent. 

This is the nunber of user labels allocated for the 
file. Since each label is a sector long, this is also the 
nunber of sectors allocated for user labels. 

This is the end-of-data pointer for the user labels. It 
is analogous to FCBEOF in that it represents the nunber 
of labels written. The initial value is 0. 

This is the logical device nunber of the first extent of 
the file. 

This is the previous lock state of the file and is 
derived fron the file label. Legal values are: 

0 - no accessor? 
t - read 

2 - urite 

3 - read/urite 

If the file resides on a private volune, then this field 
""represefits the nourited volune table index of the volune set 
entry on which the file resides. 



This is the DST of the neu FCB for the file. It is used 
in conjunction with FCBRCBDST to nove the FCB to a 
systen (shared FCB) control block table when the second ac- 
cessor is established. If this value is zero then 
there is no neu FCB; if nonzero then a neu FCB has been 
created. 

This is the vector table entry of the neu FCB for the 
file. It is used in conjunction uith FCBRC8V to nove the 
FCB to a systen (shared FCB) control block table when 
the second accessor is established. If this value is zero 
then there is no neu FCB; if nonzero then a neu FCB has 
been created. 



File Systen 

FCBQCNT This is the nunber of accessors for the file. 

Alternatively it can be vieued as the nunber of PflCBs 
created for the file. 

FC6QCNTIN This is the nunber of file accessors having input 

access. 

FCBOCNTOUT This is the nunber of file accessors having output 

access. 

FCBRIN This is the HIH nunber used to support dynanic locking 

(i.e. FLOCK and F UNLOCK) for the file. If there is no 
dynanic locking then this nunber is zero. 

FCBSECTOFF This is the sector offset fron the file label to the 

first block of the file. This is not necessarily equal to 
FCBLBL+1 since an integral nunber of blocks are allo- 
cated for the file and user labels. 

FCBSECTPBLK This is the nunber of sectors in a block for the file. 

FCBSI2E This is the size, in words, of the conplete FCB. It in- 

cludes the extent nap, 

FCBSTflRT Block nunber of the file's start, excluding the file 

label block. 

FCBSUBTYPE This is the device subtype nunber of the first extent. 

FCBUSERLBL This field describes the user labels for the file. It con- 

sists of FCBLBL and FCB LB LEQF, described separately. 

FCBVtlflSK If the file resides on a private volune set, this bit nask 

signifies uhich volune of the set in uhich the file resides. 
Bit 15 is on it resides on the first volune, bit 14 if on 
the second, etc. 



FCBNUflEXTS This is the naxinun nunber of extents, less one, al- 

lowed for the file. It is not the nunber of extents 
presently allocated, uhich is always detemined by 
counting nonzero entries in the extent nap, 

FCBNUHOPENCLSREC NuHber of open and close records in the nessage file. 
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File Label fFLRB) 
The file label has the follouing Fornat: 















0 1 2 


3 7 


S 12 


13 14 15 






I FILE NANE - 


1ST CHAR. 


I FILE HflnE - 


2ND CHAR. 


0 


FLLDCtffillE 


I FILE NAnE - 


3RD CHAR. 


I FILE NAnE - 




4TH CHAR. 


1 




I FILE HflnE - 


5TH CHAR. 


I FILE NAnE - 




6TH CHAR. 


2 




I FILE NflflE - 


?TH CHAR. 


I FILE NAnE - 


8TH CHAR. 


3 




I GROUP NAnE - 


1ST CHAR. 


I GROUP NAME - 


2ND CHAR. 


4 


FL&RPNAflE 


I GROUP HAnE - 


3RD CHAR. 


| GROUP HflnE - 


4TH CHAR. 


5 




I GROUP NAME - 


5TH CHAR. 
3 


| GROUP NAnE - 


6TH CHAR. 


6 




I GROUP HflnE - 


7TH CHAR. 


I GROUP NAHE - 


8TH CHAR. 




7 




I flCCT NflnE - 


1ST CHAR. 


I ACCT NAME - 


2ND CHAR. 


10 


FLACCTNHnE 


| flCCT NAnE - 


3RD CHAR. 


I ACCT HAttE - 


4TH CHAR. 


" 




| BCCT NAME - 


5TH CHAR. 


I ACCT HAnE - 


6TH CHSR. 


12 




I ACCT NflllE - 


7TH CHAR. 


I flCCT NflllE - 


8TH CHAR. 


13 




I CREATOR HPJ1E 


- 1ST CHAR. 


! CREATOR NAnE 


- 2ND CHflR.I 14 


FLUSERID 


I CREATOR HflnE 


- 3RD CHAR. 


I CREATOR HflnE 


I 

- 4TH CHAR. | 15 
1 




I CREATOR HflnE 


- 5TH CHAR. | CREATOR HAnE 


- 6TH CHAR. | 16 
I 




I CREATOR HflnE 


- 7TH CHAR. 


| CREATOR NAAE 


- 8TH CHAR. | 17 




I LOCKUORD - 


1ST CHAR. 


I LOCKUORD - 


2HD CHAR. 


20 


FLLOCKUORD 


I LOCKUORD - 


3RD CHAR. 


I LOCKUORD - 


4TH CHAR. 


21 




I LOCKUORD - 


5TH CHAR. 


I L0CKU0R0 - 


6TH CHAR. 


22 




I LOCKUORD - 


7TH CHAR. 


I LOCKUORD - 


STH CHAR. 


23 






SECURITY MATRIX 




24 
25 


FLSECBX 


I FILE LAH&UA&E ATTRIBUTE 


1 


1 SR | S 


26 





File Label tCont. ) 
CREATION DATE 



LAST ACCESS DATE 
LAST flODIFICATION DATE 
FILE CODE 

c | ] nvTABx | vnRSK 

S I R I L I X I SUBTYPE I DISC TYPE I R/U 
NO. USER LABELS URITTEN I NO. USER LABELS AVAIL. 



FILE LIflIT IN BLOCKS 



FCB VECTOR 



CHECKSUn 
COLD LOAD ID 
FOPTIOHS 
RECORD SIZE IN BYTES 
BLOCK SIZE IH UORDS 
SECTOR OFFSET I I NO. EXTENTS -1 
LAST EXTENT SIZE IN SECTORS 
EXTENT SIZE IN SECTORS 



END OF DATA POINTER 

VOLUnE TABLE INDEX I 

1ST EXTENT SECTOR NUnBER 



27 


FLCREATE 


30 


FLLASTACC 


31 


FLLASTnOD 


32 


FLFILECODE 


33 


FLPVINFO 


34 


FLLOCK 


35 


FLUSERLBL 


36 


FLFLIB 


37 




40 


FLFC8VECT 


41 




42 


FLCHECKSUn 


43 


FLCUD 


44 


FLFOPTIONS 


45 


FLRECSIZE 


46 


FLBLKSIZE 


47 




50 


FLLBSTEXT- 




SIZE 


51 


FLEXTSIZE 


52 


FLEOF 


53 




54 


FLEXTHAP 


55 
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File Libel (Cont.) 



VOLUHE TABLE INDEX 



LUST EXTENT SECTOR NUBBER 



FILE ALLOCATION TIRE 
FILE ALLOCATION DATE 



1154 f LRLLOCTINE 
I 

1155 

1156 FLALLOCDATE 



START OF FILE BLOCK NUBBER 



BLOCK HUBBER OF END OF FILE 



i 161 
-I 

I 162 FLENO 



I 163 
-I 



NUBBER OF OPEK AND CLOSE RECORDS (BESSAGE FILE) I 



I 164 FLNUBOPENCLSREC 



I 165 
-I 



DEVICE NAHE - 1ST CHAR. I DEVICE NABE - 2ND CHAR. |174 FLOEVNflBE 

I 

DEVICE NABE - 3RD CHAR, | DEVICE NABE - 4TH CHAR. 1 1 75 

I 

DEVICE NABE - 5TH CHAR. | DEVICE NAUE - 6TH CHAR. 1 176 



DEVICE NABE - 7TH CHAR. | DEVICE NABE - 8TH CHAR. 1177 



Other identifiers used: 



FLSECURE = FLAB(22).(15:1)8, 
(FLSRREl£ASE)= FLA8(22).(14:1 )*, 
FLCLASSFLG = FLPVINFO. (0:1)11, 
FLBVTRBX = FLPVINFO. (4:4)*, 
FLVBASK = FLPVINFO. (S:8)#, 
(FLSTORE) = FLBB(28).(0:1)H, 



file secure bit 

STORE/RESTORE released bit 

Class flag bit 

Bounted volune table index 

Volurte nash 

file being stored 
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FLEXCL 



File Systen 



Nunber of current data blocks (that is, the end of file 
block nunber relative to the start of file). 

This is the end-of-file pointer for the file. It is a 
double word integer representing the nunber of records in 
the file. It can also be viewed as the record nunber 
of the next record past EOF. 

This is the exclusive access flag for the file. If set it 
neans that the file has been opened exclusively by a single 
accessor. If not set then the file is potentially 
accessible by others. 



tap of the file. The nunber of ex- 
by FLNOBEXTS; a OD extent 
that the extent has not been 



FLRESTORE 

(FLLORD) 

FLEXCL 

FLSR 

FLSRL 

(FLSRLX) 

FLSUBTYPE 

FLOTYPE 

FLSTATUS 

(FLLBLEOF) 

(FLLBL) 

FLSECTOFF 

FIHUBEXTS 

FLLRBEL 

FLVTAB 



Discussion: 
FLACCTNABE 

FLRLLOCDATE 
FLALLOCTIBE 

FLBLKSIZE 
FLCHECKSUn 



FLCREATE 
FLDEVNABE 

FLDTYPE 
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This is the extent 
tents is specified 
descriptor indicates 
allocated. 



FLFCBVECT 
FLFILECODE 



This is the extent size, in sectors, of the file. All ex- 
tents in the file, except the last, have this extent size. 
This is a logical value, and legal values range fron 1 to 
65535 sectors. This linits the naxinun file size to 2097120 
sectors. 

If nonzero, this is the vector of the FCB for the file. 
If zero, the file is not being accessed. 

This is the file code of the file. Known values are: 



1024 
1025 
1026 
1027 
102S 
1029 
1031 
1035 
1036 
1037 
1040 
1041 
1042 
1050 
1051 
1052 
1054 
1055 
1056 
1057 
1058 
1059 
1060 
1070 
1080 



User Subprogram Library 

Basic Data 

Basic Progran 

Basic Fast Progran 

Relocatable library 

Progran File 

Segnented Library 

View Fom File 

View Fast Foms File 

View Reformat File 

Cross Loader ASCII File (SAVE) 

Cross Loader Relocated Binary File 

Cross loader ASCII File (DISPLAY) 

Edit Ouick File 

Edit KEEPS File (COBOL) 

Edit TEXT File (COBOL) 

TOP Diary File 

TOP Proof Barked QflARKED 

TOP Proof flarked non-COBOL File 

TOP Proof Harked COBOL File 

TOP Uorkfile 

TOP uorkfile it'M'< 1 

RJE Punch File 

QUERY Procedure rile 

«S=B Key File 
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■■ FLA8(28).|1:1)#, 
' FLAB(28).(2:1)#, 
■■ FLRB(28).(3:1)*, 

■ FLAB(28).(0:2)#, 
' FLAB(2S).(0:3)», 

■ FLAB(28).(0:4)H, 

■ FLAB(28).(4:4)», 

■ FLAB(28).(8:6)», 

■ FLAB(28).(14:2)», 
' FLAS(29).(0:8)», 

■■ FLAB(29).(S:8)«, 
' FLA6(39).(0:8)«, 
' FLAB(39). (11:5)11, 

FLOeDBL(22)#, 
• FLAB(44).(0:8)», 



file being restored 
file loaded 
exclusive access 
S 4 R bits 
S, R, 4 L bits 
S, R, L, & X bits 
device subtype 
device type 
u rite/ read status 
no. labels uritten 
no. labels available 
sector offset to data 
no. extents less 1 
label VTAB and sector 
label VTAB index 



This is the account nane of the file. It is eight 
bytes in length uith trailing blanks added. 

Date that the file was allocated on this systen. 

Doubleuord containing the tine that the file uas al- 
located oh this systen. 

This is the block size, in sectors, of the file. 

This is the exclusive-Ofi checksun of the file label (ex- 
cluding words 34, 42, and 43 octal) and is used for error 
detection. Each tine the file label is read fron di6c the 
check sun is calculated and conpared against the value 
recorded in the file label. Sinilarly, each tine the file 
label is uritten to the disc the check sun is calculated 
and inserted into the file label. 

This is the cold load nunber in effect the last tine that 
the file uas accessed. This should always be the current 
cold load nunber. If it is not, it rteans that the systen 
crashed while the file uas open and that the data in the 
file label should be "reset" (principally the FCB vector 
FLFCBVECT). 



It is in the for- 



This is the creation date of the file, 
nat defined by the intrinsic CALENDAR. 

This is the FOPEN device specification that uas used when 
the file was created. This information is needed uhen neu 
extents are allocated. 

This is the device type nunber of the first extent of the 
file; see ACBDTYPE for a list of legal values. This 
value is determined by configuration. 
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1083 
1084 
1090 
1100 
1101 
1102 
1103 
1110 
1111 
1112 
1114 
1130 
1131 
1132 
1133 
1139 
1140 
1141 
1145 
1146 
1147 
1148 
1149 
1152 
1153 
1156 
1157 
1158 
1159 
1166 
1167 
1177 
1178 
1192 
1193 
1194 
1211 
1212 
1226 
1227 
1228 
1229 
1230 
1235 
1236 
1258 
1259 

8000 
to 

9r\Qo 



GRAPH Specification File 
User Logging Log File 
Self -describing File 
HPUORO Docunent 
HPUORO Hyphenation dictionary 
HPUORD Configuration File 
HP 2601 Environnent File 
IOS/3000 Character Cell File 
IDS/3000 Forn File 
IFS/3000 Environnent File 
Graphics Inage in RASTR Fomat 
0PT/30O0 Log File 
TEPE/3000 Script File 
TEPE/3000 Log File 
APS/3000 Log File 
BPEDCP/DRP Log File 
HPToolset Root File 
HPToolset Data File 
Drauing File for HPDRAU 
Figure File For HPDRAU 
Reserved 
Reserved 
Reserved 

Conpressed SLATE File 

Expanded SLATE Uorkfile 

Store File for RAPID/3000 Utility DICTD8U 

Code File for Transact/3000 Conpiler 

Code File for Report/3000 Conpiler 

Code File for Infom/3000 Conpiler 

KPDESK Distribution list 

HPDESK Text 

Tem Type File 

Tern Vertical Fornat Control File 

Network Configuration File 

Network Trace File 

Network Log File 

Reserved 

Reserved 

VC File 

OIF File 

Language Definition File 
Character Set DeFinition File 
Formatted Application Bassage Catalog 
Reserved 
Reserved 

Pathflow STATIC File 
Pathflow DYHABIC File 



Reserved for APL 



This is the end-nf-space pointer for the file. It is a 
double integer representing the naxinun nunber of 
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records (fixed length record fornat) or blocks 
(undefined or variable length record fomat) in the 
file. 

FLFOPTIONS This is the FOPTIOHS of the file. 

FLGRPNHflE This is the group nane of the file. It is eight bytes long 

with trailing blanks added. 

FLlflBEL This is the volune table index and sector nunber of the file 

label, which is the sane as the first extent descrip- 
tor. FLLASTACC This is the last access date of the 
f ile . It is in the f o mat defined by the intrinsic 
CALENDAR. 

FLLflSTflOD This is the last Modification date of the file. It is in 

the fornat defined by the intrinsic CALENDER. 

FLLASTEXTSI2E This is' the size, in sectors, of the last extent in the 
file. If the file has one extent, then this is the sane as 
FLEXTSIZE; if the file has nore than one extent, then this 
value Hay be different fron FLEXTSIZE. This is the size 
of the last physical extent for the file; it is not the size 
of the last allocated extent. 

FLLBL This is the nunber of user labels allocated for the 

file. Since each label is a sector long, this is also the 
nunber of sectors allocated for user labels. 

FLLBLEOF This is the end-of-data pointer for the user labels. It 

is analogous to FLEOF in that it represents the nunber 
of labels written. 

FLLQAD This is the LOADED flag for the file. If set, it neans 

that the file is a loaded progran or SI file and cannot be 
Modified except by a privileged accessor. This flag is set 
and cleared by the loader, not the file systen. 

FLLQCK This identifies the nord containing the lock bits, 

which are described separately. 

FLLOCKUORD This is the lock word of the file. It is eight bytes long 

with trailing blanks added. If it is all blanks, then the 
file does not have a lockuord. 

FLLOCNAME This is the local nane of the file. It is eight bytes long 

with trailing blanks added. 

FLHUflEXTS This is the nunber of extents, less one, allowed for the 

file. It is not the nunber of extents allocated. Legal 
values range fron 0 to 31, i. e., 1 to 32 extents. 

FLNLfflDPEMCLSREC Nunber of open and close records in the nessage file. 
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FLPVINFO 

FLRECSIZE 
FILESTORE 



File label private volune infornation. 
fornat as the FCBPVINFO. 



This is in the sane 



FLSRL 
FLSRLX 
FLSRRE LEASE 



This is the record size of the file in negative bytes. 

This is the RESTORE flag for the file. If set, it neans 
that the file is being RESTOREd and cannot be accessed. 
RESTORE also sets the STORE bit for the file (FLSTORE); see 
FLSR for a full description of the use of these bits. 
This flag is set and cleared by STORE/RESTORE, not the 
file systen. 

This is the security natrix of the file. The bits 
are organized into five groups of six bits each. (Bits 0:2 
are not used.) The groups correspond to the access types: 
READ, APPEND, WRITE, LOCK, and EXECUTE. within each group, 
each bit specifies uho nay have the access: ANY, ACCOUNT 
n&R, RCCOUNT LIS- R ASIAN, GROUP, GROUP LIBRARIAN, CREATOR. 

This is the sector offset fron the file label to the 
first block of the file. This is not necessarily equal to 
FLLBL+1 since an integral nunber of blocks are allo- 
cated for the file and user labels. 

This is the file security enforcenent flag for the 
file. If not set, then the file has been RELEASEd and the 
security natrix FLSECfIX should be ignored. If set, then 
secure as specified by the security natrix. 

This is the STORE and RESTORE flags for the file, which are 
described separately. STORE and RESTORE decode the tuo-bit 
field to indicate their operation. Legal values are: 

0 - file not in use by either STORE or RESTORE 

1 - illegal value 

2 - file being STOREd 

3 - file being RESTOREd 

The file systen interprets the leftnost bit as in- 
dicating that the file is being accessed by either STORE 
or RESTORE. The rightnost bit is interpreted as indicating 
what access should be pernitted: 0 (file being STOREd) 
allows read access; 1 (file being RESTOREd) allows no 
access. This field is set and reset by STORE/RESTORE, 
not the file systen. 

This is the STORE, RESTORE and LOADED flags for the 
file, which are described separately. 

This is the STORE, RESTORE, LOADED and exclusive flags for 
the file, which are described separately. 

This flag is used by STORE/RESTORE. If a file is 
STOREd with the "; RELEASE" keyword, STORE uill set this flag 
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FLSTHRT 
FLSTRTUS 



FLSTORE 



FLSUBTYPE 



File Systen 



in the tape copy of the file label. RESTORE uill allow 
any user to access such files, regardless of the file's 
nomal security. If this bit is off in the tape copy of the 
file label, RESTORE applies nomal security checks (as 
defined by the infomation in FLSECfIX and FLSECURE). 
This bit is zero for files on disc. 

Block nunber of the file's start, excluding the file 
label block. 

This is the read/urite status of the file. Legal 
values are: 

0 - no accessor* 
t - read 

2 - urita 

3 - read/urite 

This is the STORE/RESTORE flag for the file. If set it 
neans that the file is being either STOREd or RESTOREd. The 
RESTORE bit (FILESTORE) iiust be interrogated to deternine 
which operation is taking place; see FLSR for a full 
description of the use of these bits. This Flag is set and 
cleared by STORE/RESTORE, not the file systen. 

This is the device subtype nuMber of the first extent of 
the file. This value is detertiined by 
configuration. 

This is the creating user nane of the file. It is 
eight bytes long with trailing blanks added. 

This field describes the user labels of the file. It con- 
sists of FLLBL and FLLBLEOF, uhich are described 
separately. 

This is the volune table index of the first extent of the 
file. 
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File Multi-Access Vector Table (FURVT) DSTKSti 

The FflRVT is used to locate shared PACS's for files opened Multi-access. 
Uhen an old disc file has been opened nulti-access, the FilAVT is searched to 
deternine if the file has previously been opened. The JITDST and the QflODR 
found in the FflfiVT are conpared to the JITDST of the job and the DftDDR of the 
device or disc file being opened nulti-access. If an entry exists for the 
file, then the PPXB can be easily located for that file. If this is the 
first process opening the file, then an entry is created and inserted into 
the FFWAT for the file. 

Spoolfiles are opened nulti-access, therefore, they will have entries in the 
FftflVT. 5STDIN and SSTDLIST also have entries in the FflRVT since they too are 
opened nulti-access. 



Zero Entry Fomat 



1 CURRENT TABLE SIZE 

1 - 


1 o 


FIT CURR' SIZE 


I ENTRY SIZE . 6 


1 1 


FIT ENTRY' SIZE 


1— 

1 nRXlnUM TABLE SIZE 

| 


1 

1 Z 


FH' MX' SIZE 


1 0 

1 - 


1 

1 3 




1 0 


- 1 

1 4 




! 

I 0 


- 1 
i 5 





Descriptions: 

FJI'CURR'SIZE The current size of the FflRVT in uords. This value increases 
in increnents of 1200 words until Ffl'TIAX'SIZE is reached. 

FIT HflX' SIZE The naxinun allowable size in uords that the Fft'CURR' SIZE can 
get. The current value of this is Z4Q00. Frt'flflX' SIZE can be 
changed only by changing the code in Initial. The open of the 
nulti-access file is failed if this naxinun is reached. 

FIT ENTRY' SIZE Size in words of an FflRVT entry, 6 uords at present. 
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Typical Entfv Fornat 

0 12 3 S 7 8 

1 I 6 I D | | 

JIT DST 
UOHCHL DEVICE I 

DISK ADDRESS 



12 13 14 15 



PRCB VECTOR 



I 0 
-I 

I 1 fh'titdst 
-I 

I 2 FITDflDC* 
I 

I 3 
-I 

I 4 FN'PACBV 
i 

I 5 



FIT DEVICE = FilAVT(0).(Z:1)«, Device bit 

Ffl' GLOBAL = FHBVT(0).(1:1)», Global nulti-access bit 

FB'LDEV = Ffl'DAD0R(0).(0:3)B, Logical device nunber of file 

Descriptions: 

fn'DRDDR The disc address of the File label for disc Files. For device 
files, the disc address is zero. 

FR' DEVICE This bit is 1 for device Files and 0 for disc files. 

Flt'LOEV Logical device nunber of device files or the LDEV of the disc 
containing the file label For disc files. 

Fn'JITDST The OST nunber of the JIT for the job that has the file open. 

If this field is nonzero, then only processes in the fatiily 
tree of this particular job can open the file. This field is 
zero if the file uas open global nulti-access. 

Fli'GlOBAL This bit is 1 if the file uas opened global nulti-access, this 
allous Multi-access to the file between jobs. 

FH'PflCBV The PRCB vector for this nulti-access file. Used to easily 
find the Physical Recess Control Block for files opened 
nulti-access. 
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File Systen 



Systen Global Area (SYSG108) 



The File systen uses several words in the systen global area for its oun 
use. 



SHFCBDST 
IWMITOR 
HRXSSECT 
HUHSSECT 
EXTSSECT 
SPOOUNDEX = 
CSIOURIT • 
CCLOSEPLRBL = 
DSCHKPLABL = 
DSOPEHPLRBL = 
DSCLOSEPLRBL - 
SDSLDEV LABEL - 
IWHUCPLRBL • 
GLOBALAFTDST : 



SYSDB*Z76, 

SYSDB*Z77, 

SYSDB*ZTOO, 

SYSDB*Z!02, 

SVSDB+XKM, 

SYSDB*Z132, 

SYSDBtZ135, 

SYSDB*Z140, 

SYSDB+Z335, 

SYSDBtZ336, 

SYSDB*Z337, 

SYSDB*Z323, 

SYSDB«340; 

SYSGLBEXW21 



shared CBT DST no. 
nonitoring flag uord 
nax spoolfile sectors 
current # spoolfile sectors 
# sectors/spoolfile extent 
class spool index 
CSIOURIT PLRBEL 
CS CCLOSE PLRBEL - FPROCTERrt 
DSCHECK PLRBEL 
DSOPEN PLRBEL 
OSCLDSE PLRBEL 
PLRBEL for SDSLDEV 
NANHGEURITECONV PLRBEL 
Global RFT DST nunber 



SIRs, Locks, and Deadlocks 

The file systen uses tuo SIRs: the File SIR, uhich is intended to protect 
file label integrity, and the FflfiVT SIR, uhich is to guarantee the integrity 
of the FURVT. Since the file systen locks these resources and also locks 
control blocks, deadlocks can occur if locking is done in the urong order. 
Not only nust the file systen handle locking correctly, but the entire en- 
senble of the file systen, its callers, and its callees nust do so also. 
These include KSfln, uhich has a SIR of its oun, SYSDURP, and STORE, uhich 
lock the File SIR because they tueak bits in file labels. The presently ac- 
cepted order is: 

Get FURVT SIR Lock RCB Get File SIR Lock FCB 

It nay not be necessary to do all of these things in any particular proce- 
dure. In nodifying a procedure, you should be sure that any of these locks 
uhich you change are consistent not only uithin your oun code, but also uith 
its callers and callees. 
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Shared CBT DST 

In sysglobal Z76 (ABSOLUTE Z1076) there exists the shared Control Block Table 
OST nunber. This DST holds a list of shared CBT's. Shared CBT's are used to 
keep any and all file systen control blocks that have the potential to be 
shared between processes. Rny disc file opened shared uill have its FCB kept 
in one of these CBT's. Also, all teminal PRCB's uill be stored in a systen 
shared CBT so that an extra data segnent is not Hasted. This is possible be- 
cause all teminal access is perforned NOBUF, uhich neans that the PRCB uill 
be a nininal PRCB and can be placed in these CBTs. Lastly, any file opened 
uith global File access uill have all its control blocks placed into these 
systeH CBT's. 

The fornat of the systen shared CBT DST is sinilar to a Control Block Table. 
It has the sane words of overhead and the data (the list of DST's) starts in 
the next word after the overhead. The systen CBT's are created one at a tine 
as needed. Usually, there are only a feu DST's in the list. 



TABLE SIZE IN UORDS (Z20O) 



DST NuTIBER OF THIS TABLE 
0 



1ST. SHARED CBT DST NUHBER 
2ND. SHARED CBT DST NUF1BER 



118TH. SHARED CBT DST NUHBER 
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The operating tysttn naintaine ititt, control, and accounting infoma- 
tion on tach prectflt. Tht date etructvrat for this purpett art tht 
proem control block tablt (PCB; cort resident, 1 entry per process) 
and tht procttt control block intension (PCflKj contained in tha prsctsa' 
stack btlou DL). Proctta rtlattd information uhich nuat bt accessible 
uhtn tht proem' atack ia not praaant in nain ntnory ia naintaintd in 
tht procesa' PCS entry. All othar proctaa rtlattd infomation la nain- 
taintd in tht proem' KM. 

A proctaa la identified in tht tyattfl by ita PCS entry nunbtr, rtferrtd 
to at ita PIN (proctaa idtntification nunbtr), or by ita 
PCBPT»(P»)«(PC8 tntry tilt). 

Tht ttnjcturt of tht PCS tablt, PCS entry fomat, FCBX itructure, and 
PCBX Fomat art aptcifiad m thia chapter. 



Proctaa Control Block Tablt Structure and fomat 
Fi«td Ctllt lltlated to PCB 



4 PCS relative index of current proem' PCS entry 
11003 Absolute address of the PCB tablt bast 

Tht bank S. addrtte art represented at per tht nPEV ERS. 
Z1271 PCS relative address of head of dispatching queue's PCB 

entry 

XI 272 PCS relative address of tail of dispatching qutut'c PCB 

entry 
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Procttt 

HI i«\<y 0 fgmat 



I- 



• OF CONFIGURED ENTRIES 



ENTRY LENGTH (125) 
< OF yNASSIGKD ENTRIES 



3 1 TABLE RELATIVE INDEX TO FIRST UNASSIGNEO ENTRY 
a. j TABLE RELATIVE INDEX OF LAST FREE ENTRY 



S| HIGH UATER BARK 

I 

6: Nun8f.fi OF PRIBBAY CONFIGURED ENTRIES (0) 



7 ! HEAD OF InPEDED QUEUE PCB RELATIVE IkOEX 

I 

SITAIL OF InPEDED OUEUE PCB RELATIVE INDEX 



SINUflBER OF CURRENTLY IflPEDEO PROCESSES 
I 

lOiNunsER of nnxinun iiipeded processes (current) 



HICjuULATIVE NUnSER OF InPEDED PSOCESSES(CURRENT) 



141 

I- 
1SI 



17I 

I- 
181 



201 
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Unassiqned PCB Entry Fomat 



Assigned PCB Entry Fomat 



1 1 TABLE RELATIVE INDEX TO NEXT UMSSIGNEO EHT8Y 



0 1 2 3 4 S 6 7 S 3 10 11 12 13 14 
|-.|_.|.-|.-i_-|__|__|-|_.|„|._|„|__|„|__ 

PCBOOIS IB IC |H IP |H II |P ID IL IS IT |U |H IS 

|A iF |R IS II IS IP IC IS !U (U |R |S II IT 

iR I II II 10 IP IE I 10 | I iU |E IP 10 

I I |T [R IV IR IX | iF | | | ID IR IV 

I I I I II II If I IT I I I 19 II it 

I 

PCB01I SLL RELATIVE ADDRESS Of PROCESS' SEOIIENT 
I LOCALITY LIST 



I ai /I 

PCB02I D| /| 
I Bl /I 

I 

I AI S| 

PCB03I 01 CI 



I- 



101 

I- 
111 
I- 

121 

I- 
13i 

I- 
141 

I- 
151 

I- 
161 



I I I I I Bl | u| j| ti m si | II si ti n 

PCB04I Bl R| R| B| II II C| Nl II SI 0|FA| K| I! II E 

I I gi li A| oi o| P| k| ni ol Nl I pi R| ni n 



PCBOSI 



FATHER'S PCB INOEX 



PCBOSI 

I- 
PCB07I 



SON'S PCB INDEX 



BROTHER'S PCB INDEX 



191 



I |U I 

PCBOSI IS I 

I psin |o I 

IF I 

IT I 



I — 
PCB09IL I 

II I 

IV I 



I Dl I 

I EIF | 

I AIR 

I DIC I 

I I I 



BUS I PPC IS I PTYPE IS 1HK | SK 1ST jHBICY |BK 
I 10 I II I I I I I I 

I !V I I I I I I I I 



I US 



PCB11I 

I- 
PCB12I 



SEOIDENTIFIER OF LAST REFERENCED 
SUPPPBBLE CODE SEGBENT 



PCB13ID |L 

II 10 

IS I 

IP I 

10 I 



C ID IE II IC IA I 

I I IN 10 IS I 

I I IT IR 10 I 

I I IE IE IF | 

I I IR |R IT I 



OBXCSINFO 

STKINFO 

iiAKEHASK 

FATHER INFO 
SOHINFO 



EVENTFUGS 
LASTREFSUAPSEG 
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Process 


Process 






- Rssiene 


d MS Drtrv Format (Com.) 




(3:1) 


HJL nail uait. 








(4:1) 


SIC. blocked I/O wait. 










(5:1) 


12. Ift wait. 


PC614I 




8LKIMX I P8X 




(5:1) 


UW ijcop wait and RIT wait. 


I- 








(7:1) 


lax. junk uait. 


PCB15I 




CST nWVIMC DST » | IWPOST 




(5:1) 


"HI. tiner uait. 


1- 




I 




(9:1) 


(1S5, file systen basic IPC nessage wait. 


PCB16I 




pwp pcs ikoex l piiippw 




.00:1) 


SSX son wait. 


1- 




1 




(11:1) 


PH. father wait. 


PCB17| 




WW PCS «C€X I NIK>I>W 




'12:1) 


IflB, process uaiting to be uninpeded. 


1- 




1 




;U:1) 


U% process uaiung for a sir. 






8WUMR j SPTUJK 




.(1*1) 


tK process) wealing for * tme out. 






1 




.(IS!* J 


FBt process was-tmej for nenery. 


pam 


toii«e» of HOif POExm-Buwue ; iwn 












1 


PC805 


.(0:16) 


f ather' s PCB relative index 


PCBJOI 


KB IWEK OF PREVIOUS KB ENTRY IN dUCUC 1 PQPTR 








1" 




1 


PCB06 


.(0:16) 


SfiBt son's PC8 relative index 








PCS07 


.(0:16) 


9T^H brother's PC8 relative index 


PCBOO 


.(9:1) 


SRR =» scheduling attention required 


PC908 


.(0:3) 


P.?Jt. pseudo - interrupt node 




.(1:1) 


Bounds Flag — Privilege nod* bounds check 






■fe hard kill 




(2:1) 


CHIT ==> process is critics) 






& soft kill 




.(3:1) 


HSIR "> process has a sir 






Sfe stop 




.(4:1) 


PI0VI *»> pending PI, proem critics! 






'4; hibernate 




•(5:1) 


HSPRI «> hold sir priority 






! S. escape 




-(6:1) 


IPEXP "> incore orotect expired 






«: break 




.(?;U 


PC prt-enp.t cjpecolity 






^ nornal 




.(fttj 


BS0FT =*> BelayesV soFt sntr .peoamin§. ft pending 




(*n 


(ZJFT. QsV for soft irrBjrrueT.to uawe> procaee> 






soft utt cannojt be pracessegVhoceuse of sir 






eeet though it is waiting on another event. 






or criritai stare. PSEOOOWT uiII be invoked' 




.!*r21 


6»- 






uhen these condition(s) go away. 






0: other source 




• (9: 1 ) 


LU «> long usit 






■<*:-. father 




.(10:1) 


SU ==> short wait 






son 




.(11:1) 


TRU es> termnal reed usit 






iV. reply done on RIT wait 




-(12:1) 


USEDQ =*> used a quantun since transection began 




.(6:11 


Otfttl. set during expiration. 




•(13:1) 


rSIPRI **> hold inpeded priority 




.(7:1) 


if set, the father is to be activated on process 




.(14:1) 


STOVP. «> processing abort due to stack overflow. 






semnation. 




.(15:1) 


RITBK==> Request Information Table 8re#k 












PCB09 


.(0:1) 


Jffi, set if process is aiive. 


PCSOt 


. (0: 16) 


SLLPTR, SU relative index to process' segnent 




-(1:2) 


BPS. block "ail. "lid if nil set 






locality list 






3t, sent to father 










P: received fron father 


PCB02 


.(0:1) 


ROB, set if DB pointing to an absolute address 






£ send to son 




•(2:14) 


XDS, DST entry nunber of extra data segntnts to which 






3: received son 






08 is set; zero if none. 




.(3:2) 


RC, process to process connunication, set with 












respect to son. 


PC903 


.(Ortf 


STOWWtt UK stecfc tntrtlm is already, stiocatsjd 






Sr. notL 




.(1:2) 


SC. set if executing systen code 






1: son to father- 




.(2:14) 


DS 1 entry nunber of process" stack 1 






.2- Fanner to son- 










t blocked 


PCB04 


(0:1) 


ft, nourning wait. 




(5:1) 


^tW, stack overflow bit 




.(1:1) 


DC, global RIH wait. 




(6:3) 


WfPE, process type 




.(2:1) 


Rl, local RIH uait. 






<te user 






G.00.00 
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Process 


Process 








1: user, son oF nain 






PCBX Structure and Fomat 






2: user, nam 












3: user, nain, task 












4: eystcn 

5: 


PCBX General Strudure 






6: systtn, UC0P 

7: 














a— >| 


DL-si * SEG-. RF.L OL VHLUE 1 




.(SlU 


U. ut uhen the Oitpateher (and PSGU00IHD 




l- 


1 1 1 




should be wan of a. jxengajrs soft inierruuT. 




1 


dp* = ssc-> m. osvmie [ I l 




.(tfct) 


m. Kara mil peoudu, interrupt 




1- 


1 | i 




.(»T;»J 


SK. soft Rill pseudo intii root 




1 


) mum i 




.112:1) 


ST, stop pseudo interrupt 




1 


1 1 1 




.(13:1) 


HB, hibernate pseudo interrupt 




1 


I I ! 




(14:1) 


CV, control -y pseudo interrupt 




1- 


1 | 




.(15:1) 


BK, break pseudo interrupt 




, — >| 
1- 


c-% «= PXFIXED LENGTH | | 
1 | | 


PC810 


.(0:15) 


EVEHTFUsSS. one for each wit class in PC804 




1 


1 1 1 




.(15:1) 


US, uake up uaiting switch set if an auake is 




1 


1 1 1 






nisting. 




:l- 


1 ) 








1 


PtfOQ EXPWSION BRER I PXFIXED 1 


PC811 


.(0:32) 


LftSTREFSUflPSfG, segnent identifier of last 




1 


BIT nop | | | 






referenced suapoablt code segnent. 




1 

1- 


(4 words) | | 1 

1 | i 


pcan 




(QUEIITJeS INFO) 




1 


\ 1 ! 




. (0:1 ) 


OISPQ «> on dispatching queue 






1 1 

INFIXED EXPfiKSIOH I I 




.(1:1) 


L scheduling class 








-(2iU 


C echedaltfOj rler* • 




I 


i 1 




.(*»; 


tr si hedel iisj dj—i 




1 


I pat 




.(♦to 


£ arlssselissjileos 




1- 


1 sat- 






JJtltR' te > process ir inter at riser 




c—>t 


ire * PHFrtf wim i 1 




.(6:1) 


CQRER "> process is core resident 




1- 


1 | | 




.(7:1) 


RSOfT, Allou eoft interrupt. R value of 1 




1 


I I I 






inplies that user soft interrupts uill be 




1 


I 1 I 






processed, ft zero value inhibits user soft 




1- 


1 | ! 






ints (they are queued). This bit is nanaged 




1 


1 PXFILI 1 






by FIRTSTRTE and FINTEXIT intrinsics. 






1 11 




.(«:») 


Process' scheduling priority 


1 


PKFSiff PjS?P*SIull/CC*TIMCTIO« 1 1 

i i ill 


PC814 


.(0:1S) 


PBX, CSTX block nap index of process' program 




1 


1 III 


PCB15 


.(0:16) 


IMPOST, DST entry nunber of the CST napping 




d— »1 LTOeTOF SECTORS RLLDCRTED 1 I 




table. 




1 


at* PXFIXED EXPANSION | | 


KBt6V 








> OL-C r 1 


PCBTT 


.»:«> 


WPMJS, rt«'retoa^ i«4ss»>«# neat uesese* PTS- ' 




1 at-* i i 


PCB18 


.(0:16) 


BPTUNK, breakpoint link For process 




i 

1- 


OL-i 1 \ / 


pcbh 


.(0:16) 


HQPTR, PCB relative index of next proc in disp queue 




0L-->| 


1 


PCB20 


.(0:16) 


PQPTR, PCS relative index of prcv proc in disp queue 












Queue 




1 


1 

- 1 










DB — > 1 


1 






s.oo.o* 






fr.OO.Oe 
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Process 



Process 



PXGLOB Fomat 

The PXGLOB portion of the pcbx is for job infomation, and contains the sane 
job related infomation for all processes belonging to the sane job. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

|..|..|..|..|..|-|-|-|-t--|--|-l-|-|-|--l 
01 DL-a=SEG. RE I DL VALUE |0 

I 1 

1| D8-a=SEG. REL D8 VALUE |1 

! - I 

2 1 USER ATTRIBUTES 1 2 

I — - I 

3 1 JHRT INDEX 1 3 

I I 

4| JPCNT INDEX |4 

I - I 
5| JCUT INDEX |5 

I - I 

6|S8| R| TV | D| II//I/7I//I//I STACK DUI1P FLRGSI6 

I I 

niiimiiiiiiiimiinm native language i? 
i — i 

10| ACTUAL JOB INPUT LDEV IS 
| 1 

111 ACTUAL JOB OUTPUT LDEV 19 

I 1 

121 JDT DST INDEX 1 10 

I- 1 

131 JIT DST INDEX |11 

| 1 

R = restart bit Stack Dunp Flags 

I = job in/list interactive Bit 10 = Rrned 

D = job in/list duplicative Bit 11 = Suppress traceback 

TV = job type Bit 12 = Suppress ASCII 

0 = undefined Bit 13 = 0-63 to S 

1 = session Bit 14 = QINIT to S 

2 = job Bit 15 = DL to QINIT 

3 = task 

* = reserved: 

SB= stun bit ;used for stack underflow sinulation for ICF44 or ICF55. 
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PXFIXED Rssiqnnents 



The PXFIXED portion of the pcbx contains specific infomation and control 
infomation. 



c-b PXFIXED SIZE 
RELATIVE S(S-DB) 
RELATIVE Z(Z-D8) 
INITIAL Q(Q-DB) 
INITIAL RELATIVE DL (DB-DL) 
GENERAL RESOURCE CAPBBILITV(FR0I1 PROG-FILE) 
BT| LTIST |CV]CT|//|/y I//I//IU IL IC |G |A |LM|LP 
LINK TO XDS ENTRIES IN EXP. area I XDS CNT 
P| S| EXTRR DATA SEGMENT OST INDEX 
P| S| EXTRA DATA SEGtlENT DST INDEX 
PI SI EXTRA DATA SEGT1ENT OST INDEX 
P| SI EXTRA DATA SEGMENT OST INDEX 
X| Al ABORT V |RU| INITIAL CST INDEX 



MAXIMUM STUCK SIZE(HAXDATA QUIT) 
ARITHMETIC TRRP MASK 
RRITHHETIC TRAP P LABEL 
LIBRARY TRAP P LABEL 
SYSTEM TRAP P LABEL 
CONTROL Y P LABEL 
CODE TRAP P LABEL 



DATA C0I1 TERMINATION TRAP P LABEL 
IMAGE TRAP P LABEL 
RESERVED 

CUR. MAX STACK SIZEUargest value ever for Z-OL) 



LM MDST existed 

4 LP LOADPROCed 
Trap Modes 

5 .AT(0:1)-Arith. 
.LT(1:1)-Library 

6 .ST(2:1)-Systen 
.CY(3:1)-Ctl-Y 

7 .CT(4:1)-Code 

U User UDC exist 

8 L Logging 

C Share Clock 

9 G Global RIN acquired 
A fleet UDC exist 

10 / 0:1 RESERVED FOR 

| CST EXPANSION 

11 | 1:1 = 1 IF ABORT 

I IN FROGRESS 

12 < 7:1 = 0 IF HAVE R/U 



I 



ACCESS TO 
PROG FILE 
= 1 OTHERWISE 
14 | 8:8 = CST « OF SE& 
INITIALLY EXECUTED 
RT PROCCREATION 



13 I 
I 
I 
I 

15 \ 
16 

17 
18 
19 
20 
21 
22 
23 
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PXFIXED Bssiqnnents (Cont.) 
I - 



301 


PROCESS CPU TIME 


124 


1 

311 


(MSEC) 


125 


1- 
321 


MAXIMUM DATA SEG SIZE USED(IN SECTORS) 


126 


I-- 
331 


TOTAL VIRTUAL STORAGE USED(IN SECTORS) 


127 


1- 
341 


CURRENT EXTRA DATA SEGMENT SPACE 


128 


I" 
351 


MAXIMUM EXTRR DATA SEGMENT SPACE 


I 29 



I- 



361 PRIV MODE BOUNDS FLAGS I 



I- 



STOV COUNT 



371 PROCESS EXECUTION TIME REMAINDER (IN MSEC) 

I - 

40| SET TO-1 UHEN IN BREAK MODE* 

| 

41| CONTINUE FLAG (CONTINUE COMMAND)** 

I - 

42IACTUAL SIZE OF VIRTUAL SPACE ALLOCATED TO STACK 

I 

431 



ERROR LEVEL 
TujgTNSjr ropnps 

INTRINSIC ERRORS 

INTRINSIC ERRORS 

INTRINSIC ERRORS 

INTRINSIC ERRORS 

INTRINSIC ERRORS 

52ITSLR, virtual tine since last rescheduled 

I 

53ITSTB, virtual tine since transaction began 



44! 

I- 
451 

I- 
461 

I- 
471 

I- 
501 

I- 
511 



541TSSURPIN, virtual tine since suapin 

I — - 

55ITSLA, virtual tine since last absence 

I 

56ITSLD, virtual tine since last deallocation 

I 

57IQCNT, quantuns used since transaction began 

| 



Process 

PXFIXED Rssiqnnents (Cont. 
60 



61 



/|D|/|0| RESERVED FOR FUTURE SOFT INT USE 
/ICI/ISI 
/IYI/III 



148 

I 
I 



-I 



TRLX INDEX FOR KERNEL TIMEOUT PROCEDURE I 49 

1 JOB TYPE: 

62| TY | JOB/SESSION NUMBER I 50 1=SESSI0N 

I | 2=J0B 

63 1 < — (n-served ) >l 51 

I- 1 



30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 

42 

43 

44 

45 

46 



64 1 

I- 
65 1 

I- 
66 1 

I- 
67 1 

I- 



RESERVED FOR FUTURE USE 
RESERVED FOR FUTURE USE 
RESERVED FOR FUTURE USE 
RESERVED FOR FUTURE USE 
ISII 



TIMEOUT TRLX 



70I ICY | 
| 

711 

72 1 imuiiiiiiiiimuiiiiiiiiiiiiiimniiiuiii 

i 

73 1 iii/iiimiiiiiiiiniiiiiiiiiiiiiiiiimmmi 



74| PCLASSMASK 
| 

75| PROCQUESTOPUORD 



76| 



52 

53 

54 

55 

56 

57 

58 

59 

60 

I 61 
-I 
I 62 
I 

I 63 



114| 
I 

1171 



PXFIXED EXPANSION BITI1HP 



NOTES: P = 1 if opened by priv user 

S = 1 if data segnent is sharable 

PCLASSMASK * BIT MASK OF CLASSES THIS PROCESS HAS ENABLED 
PROCQUESTOPUORD. (0:4) = PROCESS PRIORITY: 7 => L QUEUE 

6 => C QUEUE 
2 => D QUEUE 
1 => E QUEUE 

G.00.00 



Process 



Process 



.(4:12)= PERSON STOPPED: 1 => STOP SEE FAULT 

2 => STOP DISC URIT 

3 -> BLOCKED I/O, HON TERMNAL 

4 => TERMNAL REM) 

5 => STOP InPEDE 

6 => STOP ACTIVE 

■ DSL UORO TlflESTAdP OF UHEN PROCESS STOPPED FOR 
REASON GIVEN IN PROCOUESTOPUORD 



DCV D DELAYED CONTROL ¥ IS PENDING (THIS SIT 

IS CHECKED BY WIN ON BOUNDS VIDLBTION TO 
DETERMINE IF GOT: 1) TRUE BOUNDS VIOLATION 
OR 2) UN INOOCED BOUNDS VIO THAT INDICATES 
THAT THE CONTROL Y TRAP PROCEDURE RAY NOW 
BE ENTERED). 

OSI STATE OF THE "ASDFT" PCS SIT UHEN CONTROL Y 

TRAP UAS ENTERED, ASOFT = 1 ALLOUS USER SOFT 
INTERRUPTS AGAINST THE PROCESS. IT IS SET TO 
ZERO UHEN THE CONTROL Y HANDLER IS ENTERED. 
IT IS SET TO ITS PRIOR STATE UHEN THE USER 
CALLS RESETCONTROL. 
* SET TO COHIWND RECORD LENGTH UHEN COIMND PENDING 
(I.E. CDMHAHD ENTERED DURING BREBK OR ENCOUNTERED 
DURING FLUSHING). 

»» CONTINUE FLAG VALUES 

0 = NO CONTINUE IN EFFECT 

1 = CONTINUE JUST ENCOUNTERED 

2 = CONTINUE IN EFFECT FOR THIS CQrWBNO 



CY FLAG 



PCBKFIXE0(56).(1:1) 



PCBXFIXE0(56).(3:1) 



■ SET BY PSEUDOINT UHEN THERE IS A PENDING 
CONTROL Y UHICH CANNOT BE PROCESSED BECAUSE 
OF SYSTEM CODE OR PRIVILEGED CODE. INIH 
CHECKS THIS BIT ON SOUNDS VIOLATION OR 
TRACE TRAP. 



SPECIFIES THE STATE OF THE USER INTERRUPT 
FLAG UHEN THE CURRENT CONTROL Y UAS PROCESSED. 



PXFIXED Expansion Bitnap 

The PXFIXED bitnap and expansion area is for use in accounting 
of extra data segments acquired by the process. 
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PCBX For Core Resident Svsten Process Stacks 



4 

5 

6 

7 
10 
11 
12 
13 
12 
13 
14 
15 
16 

I- 
171 

I- 
201 

I- 
211 

I- 
221 

I- 
231 

I- 
241 



DL-a (Seq Rel DL Value) 
DB-a (Seq Rei D8 Value) 
USER ATTRIBUTES (always -1) 

0 

0 

0 

0 I D| I| 0 
0 



PXGLOB 

I 



RCTURl JOB INPUT LDEV 
ACTUAL JOB OUTPUT LDEV 

0 

0 



PXFIXED SIZE (c-b) 



RELATIVE S (S-DB) 
RELATIVE Z (Z-DB) 



INITIAL 0 (Q-DB) 
RELATIVE DL (D6-DL) 
GENERAL RESOURCE CHPABILITY(-I) 
RESERVED 
0 

DL-c 
DL-b 
DL-a 



110 

-I 

111 
-I 

112 
-I 

113 
-I 

114 PXFIXED 
-I 

H5 
-I 

116 
-I 

117 
-I 

118 
-I 

119 
-! 

1 20 



1. There is no PXFILE area. 

2. The PXFIXED area is much smaller than a noma! PCBX. 
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Process 

Process To Process Communication Table 



This table is used as the connunication link by which father and son process- 
es connunicate mth one another via the Mailbox schene. This table contains 
two words per entry and is indexed by PCBH (entry index 0 is meaningless). 
Each tuo word entry of index N essentially relates uhere, as Hell as how 
nuch, nail nay be found for a process N with respect to communications be- 
tween N and his father process. 



ENTRY FORflRT 

| 1 

word 0 | UORD COUNT ! 
| 1 

word 1 | HAIL UORD OR DSTN | 

I I 

uhere word 0 = the # of nail uDrds to 
be transferred, 
word 1 = the only word of nail 
itself if uord 0 = 1 

otherwise 
it contains the DSTtt of 
the extra data segment 
where "word count" words 
of nail exist. 



NOTE: Assume process S is the son of process F. Then the process to process 
connunication table index which will be used for mailbox communication 
between son S and father F will be that of the son (i.e. S). 



G.OO.OO 
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Process 

Subsysten Reserved PL Area 



REHAININ& OL BREfl 



I 
I 



DB-1 21 


RESERVED FOR SORT/HERGE 


IDB-10 


DB- 1 1 | RESERVED FOR TRACE, TOOLBOX, S BUSINESS BHSIC 


ID6-9 


DB-101 


EXTERNAL P LABEL OF OUTER BLOCK 


IDB-8 


1 — 
DB-71 


RESERVED FOR TRACE t SYMBOLIC DEBUG 


IDB-7 


1 — 
08-6 1 


DB ADDRESS OF STLT 


IDB-6 


I — 
DB-51 


RESERVED FOR COBOL 


IDB-5 


1 — 
DB-4| 
1 — 


RESERVED FOR COBOL 


I DM 


DB-31 


RESERVED FOR COBOL 


IDB-3 


DB-21 
1 — 


RESERVED FOR FORHBTTER J, PASCAL 


IDB-Z 


DB-11 


DB ADDRESS OF FLUT 


IDB-1 


1 

1 

i 


DB AREA 


I 
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Process 



FORTRAN Logical Unit Table (FLUT) 



The segnenter is responsible for the preparation and initialization of a 
FORTRAN logical unit table. This is done when a progran is prepared if that 
progran contains at least one program unit that references a logical unit. 
The location of the FLUT is in the secondary DS area and the address of this 
location is contained in DB-1. 

The FLUT is formatted as per the following example: 

| 1 

DB-1 I X | 
| 1 

| 1 

DB«X | 3 I 0 I 
I— I — I 
I 4 I 0 | 
I — I — I 
I 5 | 0 | 
I — I — I 
I 7 | 0 | 
I— I — I 
110 | 0 | 
I— I — I 
1 255 1 ///I 
I 1 



1st BYTE 2nd BYTE 

List of the logical unit nunbers The fIPE file number (as returned 

referred to in this FORTRRN- by FOPEN) used in accessing the 

produced progran. file. Zero if file not open. 

(255 terminates). Filled in by fomatter as each 
l.u. is initially referenced. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
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Job Tables 



Job Tables 



CHAPTER 8 JOB TABLES 
Job Tables Overview 



Job Raster Table (JfIRT): One entry per job/session. Contains 
information needed to get the job/session running. Entry is 
created at the introduction of job/session. 

Job Information Table (JIT): One DST per job/session. Contains 
infomation needed by the job/session as it is executing. 

Job Process Count Table (JPCNT): One entry per job/session. Entry 
nunber used to index into the JIR to lock job resources. 

Job Directory Table (JDT): One DST per job/session. Contains the 
following sub-tables used by descendants of job/session, rlust 
obtain JIR (by using JPCNT index) before accessing JDT. Sub-tables: 

1. Data Segnent Directory - Directory of DSTs used by job/session 

2. Temporary File Directory 

3. File Equation Table 

4. Line Equation Table 

5. Job Control Uord Table 

Job Cut-off Table (JCUT): Stores total CPU tine linit of job/session 
and accunulates the CPU tine that job/session uses. 

Ucop Request Queue: fl queue of Process Identification Nunbers that 
are terminating. 



G.OO.CO 
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SIR = 15(10) = ZT7 
DST = 25(10) = Z31 



Job llaster Table Structure (JURT) 



ZEROTH 
ENTRY 



0 1 2 3 4 5 6 7 S 9101112131415 



! CURSI2E |0 



1 | VH0UKT INFO | ENTRY SIZE 11 

I 1 

2| ENTRY POINTER 12 



3 1 SCHEDULING HEAD POINTER 
| 

4| SCHEDULING TAIL POINTER 



13 

|4 
-I 
15 
IS 
-I 
|7 
IS 
-I 

1 1 1 LG | SEC I /////// 1 SFENCE/ 1 JOBFNCE 1 9 



5| TY| 
6| 



nax JFIRT size (uords/128) 
current JllfiT size (uords/128) 
:VWUNT state saved for UflRMSTRRTs 
JURT entry size (38) 
08 pointer to first entry (38) 

DB pointer to uord 0 of head 
entry in scheduling queue 
DB pointer to uord 0 of tail 
entry in scheduling queue 
next assignable session #, TY=1 



7| TV I 
101 



next assignable batch #, TY=2 



121 
I- 
131 



SLMIT 



JUMT 

jNun 



LG=1, logoff in progress 
SEC=0,high;<3,lou JOBSECURITY 
naxinun nunber sessions C E 

current nunber sessions I R E 
I R C 

naxinun fl batch jobs 



151 

!======««====««=«= 

16| JflflT SCHEDHEHD 
| 

17| UORKRRER 
j (23UDS) 
20| 



current t* batch jobs 



451 

1 = 
461 



-I 

110 
-! 
111 
-I 
112 

_ I 

il3 
=1 

114 
-I 

115 SFENCE is session fence 

I 

116 



1 37 



> E U 
I N T 
I T I 
/ IN 
V G 



I 38 
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1131 



JURT (Cont.l 



175 



Job Master Table Entry (JURT) 



111111 
0|1:2:3|4:5:6|7:8:9|0:1:2|3:4:5 

| 1 

01 state :D|I:G:fi|U:C: INPRi I 

| 1 

1 1 ty: job/session nunber | 



I- 

21 job/session i 



LRST 
ENTRY 



SCHEDULING QUEUE 

WRITING SESSIONS 

FIFO UITHIN HIPRI/INPUT PRIORITY 
[ERROR JOBS ) 
[ FIFO ] 
URITING JOBS 

FIFO UITHIN HIPRI/INPUT PRIORITY 



31 

41 

51 

61 
I- 

71 
101 
111 
121 



I 2 
-I 
I 



state 

0 = free entry 

1 = introduced, in 

STRRTDEVICE 
Z70 =scheduled in scheduled job queue. 



user nane 



3 140 
4 

i 5 160 
6 



-I 



account nane 



131 

14| job nane 

151 

161 

I 

171 

zi i 

221 

I 

23| JIN device 

I 

24! JUST device 



7 
8 
9 
110 
-I 
111 
112 
113 
114 
-I 
115 
116 
117 
118 
-I 
119 



waiting, job in 
scheduling queue 
initial, UCOP 
has created JSDP 
executing, JSDP 
finished initial, 
terminating, 
suspended, 
duplicative 
interactive 
group passuord 



• a - — i- > — - — - 
{(QUIET node, if state=2) 
{fl = account passuord 
{U = user passuord 
{0 = passuord validated(STRRTDEVICE) 
{1 = nust validate 
{ passuord (INITJSrlP) 
R = reserved 

C - JLIST is device 
class index 



25 



Julian date (CALENDAR) 
tine (CLOCK) 



ty = 1 • 
2 • 



session 
job 



30 | language : KPRI |24 

I 1 

31 1 Main pin 1 25 

I I 

321 CPU lin. (0 deflt, -1 no lin.)|26 

I— I 

33IS|R:N:FT :0UTPRI : NUrlCOPIES |27 

| | 

34 1 ORIGJIN 1 28 



1 29 



35I 
I- 
36! 



0RIGJL1ST 
Reserved 



ORIGJIN/ORIGJUST is 

used as a scheduling 

link by UCOP (state= 

Z40). DB relative ptr. 

Last entry in list contains zero (0) 
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Job Tables 



job Tables 



JMBT (Com.) 



I I 

37| Reserved 131 

I 1 

40| Reserved |32 

I— - - 1 

111 Reserved (33 

i I 

42| Reserved 134 

I I 

431 Reserved 1 35 

I I 

44| Unused 136 

I I 

451 Unused 137 

| | 

O|1:2:3|4:5:6|7:8:9|0:1:2|3:4:5 
111111 

R = RESTART 
H = SEQUENCED 
S = ORIGJIN is spooled. 



FT = funny terninal 

00 - regular tern. 

01 - regular tern. , 
special logon 

10 - APL tem. 

11 - RPL tern. 



JOB STRTES - JI1AT ENTRY UfJRD 0.(0:6) 

SHQUJOB - Displays job slates by scanning JHAT OST (Z31 ) 

LOGON USES RLL STRTES EXCEPT "SUSPEND" 



1 STRTE 
I NO. 


STRTE 
NflUE 


PROCESS 


1 SEB1ENT 1 
1 1 


PROCEOURE(S) | 


I 1 


INTRO 


DEVREC 

jsup 

SPOOLER 


1 NURSERY | STfiRTOEVICE ->PUTJHflT ( 
! 1 ->RLLDCENTRY IN SEGMENT I 
1 | RLLDCUTIL I 


I Z70 






IJOBSCHEO | 
1 1 


CXSTSTRERfl | 
SCHEDULEDSCHED I 


I Z40 


uniT 


DEVREC 
JSUP 

SPOOLER 


1 1 

I NURSERY | 
l\ 1 
I SPOOUNGI 
1/ 1 


STRRTDEVICE ->SCHEDULEJ08 1 
SPOOLSTUFFIN ->SCHEDULEJ08 1 


I 160 


INIT- 

IHLIZRT- 

IUN 


UCOP 


1 UCOP I 

j 


LflUNCHJOB | 


1 2 


EXEC 


JStlP 


1 NURSERY | 


INITJSHP 1 


I 3 


TERHIN- 
RTING 


jsnp 


I HOROUE | 
1 1 


TERDINRTE ->EXPIRE -> I 
CLERHUPJOB | 


1 0 


FREE 
ENTRY 


jsnp 


1 I10RQUE 1 
1 

1 1 


TERMINATE ->EXPIRE -> I 
CLERHUPJOB ->0ERLLOCENTRY I 
IN ftLLOCUTIL 1 



I 4 | SUSP | JSBP | OPLOU | CX8RERKJ0B 



For states INTRO and URIT, 

DEVREC => logon cotmand originated on terninal or 
other unspooled device. 

SPOOLER => logon cowiand originated on spooled device. 

JST1P => logon connand is the result of the execution of 
a : STRERfl connand. (This also includes USER 
processes which have done progrannatie :STREHhs. J 
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Job Process Count Table (JPCNT) 
(1 Bit Entry/Running Job ) 

HENDRY RESIDENT 



Job Cutoff Table (JCUT) 
1 Entry/ CPU-United Job 



SYSGL06 BASE = DB*13(Z15) 
DST = 24(10) 
SIR = 13(10) 



0123456789 10 12345 



BEHORY RESIDENT 

SYSGLOB BRSE - 06*11(113) 
DST = 36(10);SIR = 14(10) 
SYSGLOB t 1117 = default 
CPU tine linit for jobs 



Total Configured nunber of Jobs 
and Sessions 



Total nunber of free entries 



Bit Hap relative index of word 
containing next free entry 



Bit flap 
64 words long 



0 1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 



I * OF REAL ENTRIES 
I- 



I ENTRY SIZE (3) 
I- 



I I- 



-I FREE HEAD 



free entry = 1 
allocated entry = 0 



A JPCNT entry nust be allocated before the nain process can be procreated. 
The job SIR (PXGJSIR) > sone base*JPCNT index. 



NOTE: This table is conpletely bit oriented with each entry consisting of 
one bit. Entries are taken fron available pool on a "first found" 
basis. R "1" found in the bit nap indicates a free entry, fl zero (0) 
found in the bit nap indicates an allocated entry. Uord 2 of this 
table is the index of the word in the Bit Hap where the next free 
entry resides. Rt systen start up, this word is set to zero (0). The 
Bit Hap can be thought of as ranging fron 0-63 (64 total words - 1024 
entries). 



POINTER TO LAST ENTRY (0) 
UNUSED 



HERDER 
ENTRIES 



(2) 



JCUTCPUL 



tine linit 
(seconds) 



tine count 
(nsec) 



■>l POINTER TO NEXT FREE ENTRY (END OF LIST = 0) 
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Job Tibj.it 



Job Tables 



JIT OST*!! 1 wTrTVl'TbeM 10 M" b<G 



111111 
0!1:2:3|4:5:6|7:S:9I0:1:2I3:4:5 



not used 



I 0 

-I 

1 1 



2i pointer to job info 
I- 



-I 



3| pointer to acct info 
4| pointer to reterved area 59 I 4 



S I 2 
-—I 
48 1 3 
-I 



association table index 



JfT (Com.) 



7 1 ty : job nunber 
101 



111 

| 

121 JITnBXP 



|F| 6 

— I 

I 7 
I S 

— I 

71 9 

— I 

no 



13| JITHPIt 
I 

141 01 
I 

151 
I- 

161 



jiibsec 



112 
113 



F - Job/Session-uide 
FPflfiP option flag 
(JSFPnAP) 

ty - 1 = Seseion 
2 * Job 



JITBBXP - flflXJOSPRI capability 

JITWK - Job nam PIN. 

JITEOF - used by FCLOSE to tell CI 
that a tSTOIH(x) rile ues closed 
u/out encountering an EOF. 
(0:1)=»STuM. (1:1)=SSTDII« 



JITGSEC (2 uorde) 1 14 

group security ] 

116 



20| JITHBH (4 uorde) 

account nane 

24 1 JITHGN (4 words) 

| hone group 

I 

301 JITLGH (4 uords) 

i log-on group 



124 



0]1:2:3!4:S:6i7:S:9|0t1:2!3:4:5 
111111 
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JIT (Cont.) 



111111 
0|1:2:3|4:S:6|7:S:9I0:1:2I3:4:S 

50 ! 3 |4! Recounting Info 

| | 

51 1 JITCREC - • of creations 149 

I I 

621 JITCPUC 150 

631 cpu nilliseconde 151 

I 1 

64| not used : NIPRI I52 MPM - highest job priority 

I 1 

65| 0 I53 Recount 

66 1 JUMP 1 54 Index Pointer 

| 1 

67 1 0 |S5 Group inde« pointer 

70| JITGIP |56 Sytten volune set 

| 1 

71| 0 IWTBBX |57 Group index pointer 

72| JITHP 15! nounted private volune set 

I 1 nVIBBX - llounted Volune 

73[ 1 159 Table Index 

| 1 

761 allou tut* 162 
77 163 
1001 j« 

1011 « 

1021 166 

I 1 

0|1:2:3|4:5:6|7:8:9IO:1:2l3:4:5 
111111 

allou Basil Fomat 

The flllou nask for Iff V it expanded to six uorde. There it a natk in 
each user' j JIT and in the SYStHJM arte. The Mlou natk containt enough 
bits for a one-to-one correspondence to every preeent 0PEmT« type con- 
nand, or any future OPERATOR corwund. Uhen a user is BLLOUed any OPERATOR 

conrand or OSSOCIRTEd to a device (uhich ulll use OPERATOR type connandt) 
"en the corresponding Sit(s) in the nask in that user's JIT for that con- 
nand is set. If the flLLSU or ASSOCIATE uae done on a global scale, then 
the bit(s) in the natk of the SYSGUJS area is/art updated. 

The Follouing EOUBTEt define the natk bit for each operator contend. 

The first set of connands define the operator contends dealing uith 



5.00.00 
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111111 

011:2:314:5:617:8:910:1:213:4:5 

I I 

34| 1 2! 

35I JITUH 1 29 

36 user nane 1 30 

37| 131 

| I 

40! pointer to JITBIP 53 j 32 

41|P|H: pointer to JITGIP 55 1 33 

I I 

42 1 LATTR 1 34 

43| local attributes 135 

I I 

44 1 PASSF 1 36 

4Sl passed file pointer 1 37 

I I 

46 1 UCRP 1 3! 

47 1 user capability * 1 39 

I ! 

501 Reserved for OS'II 140 

I I 

vumiiiiiiitiiimimiiimiiiw 

K\ll!<IIIIIIIIIIIIIIIHIIIIItllllW 

1 1 

531 local RIN pointer 143 

I i 

541 W 

5S| JITJIt 145 

561 joo nane 1*6 

571 ' II' 

I I 

* » 
0|1:2:3|4:5:6|7:8:9!0:1:2I3:4:S 
111111 



P - Group' e hone volune is 
a private volune 

n - Private volune nounted 
(i.e. group bound to hone 
voiune set), JITGIP - 57 
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Uhen adding a neu connand to this set of EQUATES, be sure to add a 
corresponding nove statenent in LOGlnflGE, even if the connand uill not be 
logged. 





Uord 


Bit 


| 


BBORTIO 


0 


0 


0 


ACCEPT 


0 




1 


30U« 


0 


2 


2 


GIVE 


3 


3 


3 


KEBDOFF 


0 


4 


4 


HEBDOK 


0 


5 


5 


REFUSE 


0 


6 


6 


REPL* 


0 


7 


7 


STBATSPOOL 


0 


8 


S 


TAKE 


0 


9 


9 


UP 


0 


10 


10 


BP HUE 


0 


11 


11 


DECONTROL 


0 


12 


12 


UPPER uniT- 


OEVICE r.<mnA»s 




HBORTJOB 


0 


13 


13 


BLLOU 


0 


14 


14 


BLTFILE 


0 


15 


15 


BLTJ08 




0 


16 


8REAKJ08 




1 


17 


DELETE 




2 


IS 


DISnLLDw 




3 




JOBFENCE 




4 


20 


LIBIT 




5 


21 


STOPSPOOl 




6 


22 


SUSPENOSPOOL 




7 


23 


OUTFENCE 




S 


24 


RECALL 




9 


25 


REsunfjoe 




10 


26 


RESUHESPOOL 




11 


27 


STREAKS 




12 


2! 


CONSOLE 




13 


29 


UARN 




14 


30 


UELCOHE 




15 


31 


im 




0 


32 


nOFF 




1 


33 


vbount 




2 


34 


LP10UMT 




3 


35 


LOISBOUNT 




4 


36 


rtRJECONTROL 




5 


37 


JoeSECURITV 




6 


38 


O0UHU3AD 




7 


39 


BIOEHBBLE 




S 


40 


nlOOISBBLE 




9 


41 


LOG 




10 


42 
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Job Tables 



FOREIGN 
Mf 

SMKM 
OPE HO 

SMJTO 
OtSCRPS 



Uorg; 
2 
2 
2 
2 
2 
3 



Bit II 

11 43 

12 44 

13 45 

14 4S 

15 47 
2 48 



» THE FORMAT fOII UCRP (X46-47) IS US FOLLOUS: 

| 1 

I Ol II 21 31 4| 51 61 71 S| 9|10I1I|12|13|14|1S| 



-I 

UOROI Sn|m|nLI&L|DIiaPlCVlUViLGt//l//|MntMI|CStHOISF| 

I 

U0R02 



Ibaiiaiphi 



Iffll IDSIPHI 

I 
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Job Directory Table (JOT) 



1 | POINTER TO JOSD 

I 

2 I POINTER TO JTFD 



I I 

0 | »BX SEG SIZE(UOS) I 

I — I 

I 

-I 

I 

I I 

3 I POINTER TO JFEO i 
I I 

4 | POINTER TO JLEO I 
I I 

5 I POINTER 10 JJCU I 
I I 

S IPOINTER TO FREE SPACE I 
-I 



1 entry per job 
DST It in uord 10 
(base 10) of PXGLQ8 



UORK AREA 
IS words 



JOSJNUfl |TY| 



I JSHPIH 



job nunber 

nun process nunber 



JOB DATA 
SEGhEHT OISECTORY 



JOB TErlFORfiSY 
FILE DIRECTORY 



JOB FILE 
EQUATION TABLE 



JOB LINE 
EQUATION TABLE 



JOB CONTROL UORO 
TABLE (JJCU) 



I ENTRY INBrt 

I SIZE (UOS)I SIZE (UDS) 



ENTRY 
INFORflflTIOH 



I- 



The nane is a 

concatenation oF up to 3 subnanet. 
3it 0 of the 1st character of each 
subnane is 1 . 
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Job Oata Sequent Oirectorv Entry (In JOT) 



0 1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 



-I — I — I — I — I — I — t — 1 — ^1 — I — I — I — I — f — I- 



I 



1 



SEGMENT ID 
EXTRA DATA SEGMENT DST INDEX 
• OF PROCESSES ACCESSING 



NOTE: A rstum of 12004 in thl INDEX value after usina the GETDSEC 
intrinsic indicates that there is no nore roon in the Job Directory 
Table for another job sharabis oats < 



Job Tenoorsrv file Entry tin JOT) 



0 1 2 3 4 5 6 7 I 9 10 11 12 13 14 IS 

I — i — I — I — 1 — ■ — t — I — 1 — I — 1 — t — ( — # — • — t — ■ 
I ENTRY SIZE (UORDS) I HAflE SIZE (NOUS) I 

| 1 



Job Tables 



MA fWW" Entry »" J°'l 



0 1 2 3 4 S 6 7 t 9 10 11 12 13 14 15 

I ENTRY SIZE (UORDS) I HRHE SIZE (UORDS) I 
I I 

NfinE 

(FORMAL DESIGNATOR) 
| 1 

I MASK 

I I" 

I I 
I I 

I WW LENGTH (BYTES) I DEVICE LENGTH (BYTES) I 
| 1 

NAflE -ACTUAL DESIGNATOR 
(nay not be present) 



DEVICE/CLASS NAflE 
(nay not be present) 



NAflE -ACTUAL FILE DESIGNATOR 



- Nans is a 



VOLUME POINTER 



| 



FILE LABEL POINTER 



concatenation of up 
to three subnanes. 
Bit 0 of tht first 
character of each 
subnans is 1. 



'BUFFERS 



I INIT ALLOC ID IT IS |<- 
1 

RECORD SIZE I 



j * EXTENTS | //////// 1 I 
I FILE 
SIZE 
FILE CODE 
OUTPRI | HUncOPIES 



-disposition 
BIT13 DEL 
BIT14 TEMP 
BIT15 SAVE 



I 



REF COUNT | • OF USER LABELS 

LANG (Native Language Support) 

LENGTH FORKS'/LABEL' 

FORMS/LABEL 
ARRAY 



G.OO.OO 
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Job TulM 



Jet Lino Eauation Entm 

I I 

I ENTRY S!Zt (UOMS) I OCSIS. SIZE (UOTOS) I 



I- 



FCRnAL 
LIME OESIGNBTOR 

(1-4 uomsi 



01 



I- 



PnRSKI 

11 REF CST SIP i 

I 

21 NRHE LENGTH I 



10 
-I 

11 P'FLAG 



DEV LENGTH 12 

• I 

13 

Hone i« 

EW) OF LEO ENTRY If HGN-8LRHK ) 15 



71 
I 

101 



131 

I 

141 DRIVER NPJ1E LENGTH 

1 

151 

I 

161 

I =1 
1?i 



I" 



113 



115 



211 

1- 
221 

I- 
23| 

I- 
241 



LIST PHTR 
COPT IONS 
ROPTIOHS 
DOPTIONS 



118 

-1 
H9 



1 20 



G.OO.OO 
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Joe Tables 

JLEQ Entry (font,) 

| I 

25 1 HUflBER OF SUFFERS 121 

I I 

261 buffer size in words |22 

27| IHSPEEO (2 uorts) 123 

I I 

31 1 3UTSPEED (2 uords) I2S 

I I 

33 1 POLL REPEAT 1 27 

I ! 

34 1 POLL DELAY |28 

35 ! C TRUCE INFO 1 29 

I I 

36| LOCAL ID PNTR 1 30 \ 

| I I 

37 | REMOTE 10 PHTR 131 I 

| 1 I 

401 SUPLIST PNTR 132 I REL TO ORIS 

I | ■ | OF lEO ENTRY 

41! PHONE LIST PNTR 133 > 

I— - - I I 

421 PSLLIST PHTR 134 I 

|- - I I 

43| "ISC ARRAY PNTR 135 / 

Job Cjntrol lion) Table (JJCU) 

( 1 Har.e nay be any alpha- 

I HBflE SIZE (BYTES) I I nmtne string, bt9in- 

j 1 | rung mth an alpha, 

| | ber-esn 1 and 255 char- 

actzrs long. 

NHI1E 

] i TY 00 s GK 

| j 01 = tfiSH 

I TY | rlOOIFIER I 10 = FATAL 

| -| 11 = SYS7EH 

"10DIFIER = VRL'JE FSOB 0 r 0 J377777 
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floations and Footions Uord Sreattdoti 



OPTION UORO 2 
(ROPTIOHS) 

OI--I 
I o I 

I I 

I 0 I 

I I 

I 0 I 

I— I 

31 Icopy 

I— I 
4| |no-uait 

I— I 
51 t 

I Inulti- 

61 laccess 

I — I 

7| I inhibit buff. 

I — I 
SI I 

1 I exclusive 
91 I 

I — I 

10 i jdynanic locking 

| — Inultl- 
11 1 I record 

I — I 
1 21 



I I 



I I 

I I 

i I 

151 I 



I access type 



OPTION UORO 1 
(FOPTIONS) 

CI — I 
I o I 

I I 

I o I 

I— I 

21 I 

I Ifiii type 
31 I 

I— I 

I o I 

I— I 

5| 0 Idisallou files 

l — l 

61 | labelled tape 

I — I carriage 
7| jcontrol 

l—l 
SI I 

I I record fomat 
91 I 

l — l 
tOI I 

I I default 

I j designator 

I I 
12I I 

l—l 

131 laseii/binary 

l—l 
Ml I 

{ Idonain 
151 I 

l—l 



I I 



pnflSK Uord Breakdoun 



■ ?mx UORO 2 
• PflRSK UORO 1 



FILE TYPE 1 


I3L0CK rflC'OR 


LABELLED TRPEI 


ISECSIZE 


Fans nESSRGt 1 


1 — i 

IOISPOSITION 


USER LBSELS 1 


j | NlJflBLiFFERS 


LUNG 1 


l—l 

I 1 INHIBIT BUFFERING 


VTERn 


l — l 

I | EXCLUSIVE 


POINTER ENTRY | 


l — l 

I II1ULTI-RECOR0 


DYN. LOCKING 1 


l—l 

I 1 ACCESS TYPE 


uniT.NOUfllT | 


l—l 

1 ICOPY.NOCOPY 


nULTI RCCESS 1 


l — l 

| | CARRIAGE CONTROL 


NUflCOP 1 


l—l 

I | RECORD FORBRT 
l — l 


OUTPRI I 


1 1^rfr~AM. T "-(T' , ''HnTriB 
I I UCTfU L. i iPLO 1 JT>h «n 


FILECOOE 1 


l — l 

I ! ASCII/BINARY 

l — l 


FILESIZE 1 


I ID011AIN 


HtmEKTS 1 


l—l 

1 1 DEVICE 
l — l 


INIT ALLOC 1 


I INAflE 




l — l 
15 



1->info 
O-unfo 



present 
absent 



G.OO.OO 
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Job T «ble« 



Job T jble» 



UCOP Reautet bmi (OSTM) 



BfllO Kg ENTRIES N/2 



TA8LE RELATIVE POINTER TO NEXT AVAIL ENTRY 



TABLE RELATIVE POINTER T6 NEXT REQUEST 
0 



UCOP Entry Fonut 



Each entry 11 

Z -Orgs iC9 



uiiitiiiiiU'iiuiiiitiinwiitiii 1 
i 

I PIN 



IZ-1S 

2 



-i 2 procese deletion 
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Relocatable Object Code 



CHAPTER 9 RELOCRTRBLE OBJECT CODE 



Relocatable Object Code 
USL File Fornat [cont. ) 



USL Files Introduction 



■ * USL record length 128 uords aluays. 
* Layout of doubleuord disc addresses 





! UORD It 


25-BIT RECORD S 


I UITHIN RECORD 



0 24 25 

* Hash links join all entries mth the sane hash key regardless of 
type. 

* Linear lists terninate mth a zero link 

* Circular lists containing only the list Head point directly to 
thenselves. 

* Single-word disc addresses 



| UORD ft j 

| UITHIN RECORD j 

I 

15 



8 9 



Uninitialized fields are reserved for future use and should 
be set to zero. 



Record 0 and Overall USL File Fornat 



Ol 


LID 


0 


LOADER ID S. 


I- 
11 


HE 


1 


NR. DIRECTORY ENTRIES 


1- 

21 


DL 


I 2 


DIR. LENGTH 


1- 
31 


subdg 


I 3 


TOTAL DIR. GBRBBGE 


1- 
41 


liDG 


I 4 


NR. DIR. GBRB. ENTRIES 


1- 

51 


SBBDL 


I 5 


S.B. BLOCK DATA UST 


1- 
61 


SAIPL 


I 6 


S.fl. INTERRUPT PROC. LIST 


i- 
?l 
I- 


SBSL 


I 7 


S.B. SECflENT LIST 


I- 

101 


FL 


I 8 


FILE LENGTH 


111 




I 9 





NOTE: 

= Starting Address 
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Relocatable Object Code 



USL Files General Information (cont.) 



I RECORD 0 | 



DIRECTORY 
ENTRIES 



SARD I I 

I AVAILABLE I 

I DIRECTORY I 

I I 



32K 
flflX 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 



I I 

I INFO | 

I (HEADERS) | 

I (CODE) I 

I I 



I 



I 

AIL 
I 
I 



I AVAILABLE I 
I INFO I 
I I 



«SBI I1UST BE ON R RECORD BOUNDARY 



NOTE: ALL ADDRESSES IN RECORD 0 ARE UORD 
ADDRESSES. 
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121 


SfiflD 


10 


S.A. AVAIL. DIR. 


1- 

131 


BDL 


I 11 


AVAIL. DIR. LENGTH 


1- 
1H 
15! 


SRI 


! 12 
1 13 


S.B. INFO BLOCK 


I- 

16] 
171 


IL 


i 14 
I 15 


INFO BLOCK LENGTH 


1 

20| 
211 


SARI 


I 16 
1 17 


S.A. AVAIL. INFO 


221 
231 


AIL 


I 18 
1 19 


AVAIL. INFO LENGTH 


1 

241 
251 
1 


TOTAL 
I.G. 


1 20 
1 21 


TOTAL INFO GARBAGE 


261 


NIG 


I 22 


NR. INFO GARB. ENTRIES 


271 




I 23 




1 

301 




I 24 




1 

311 




I 25 




1 

32! 




I 26 




1 

33! 




I 27 




1 

341 




I 28 




1 

351 




I 29 




1 

361 




I 30 




1 

371 
1 




I 31 




40| 




I 32 




1 

411 
1 


HL 

0 


I 33 


HASH LINKS 


1 
1 

1 








1 

177| 
1 


HL 

94 


I 127 
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Relocatable Object Code 
USL Files General InFomation (cont.) 
SBSL— 



I SEGL | — 


>| SEGL I 


— ->| 0 


I SEG.fl I 


! SEG.K | 


I 

| SEG.B 




-ISUBL |<~ 


I 

— I 



I I 
I I 
I I 



SUBL |- 
I 

PROC.C I 



->| SUBLI- 
l I 
I PROC. A | 



->| SUBL 

I 

I nfliN 



I I 

; i 
i i 
I I 



-ISECL 



|<- 



I I 

I I 

I I 

I I 



CIRCULAR LINK POINTS TO ITSELF 
IF LIST IS EUPTY 



SECL 
PROC. A 



IPROC.R 
I 1 



->| SECLI 
I ! 
IPROC.R I 



A \ 

K >SEGT1ENT NABE ENTRIES 



A \ 
3 I 
A I 



PROC C \ 

PROC A >SUBPROGRRn 
I1AIN / ENTRIES 



1 ) SECONDARY ENTRY POINT ENTRIES 
A I 
5 / 
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Relocatable Object Code 
Data Descriptors. Passed P*ranete.rg 



0 1 2 3 4 5 6 7 8 


3 10 11 




I tlODE | STRUCTURE I 


TYPE 


TVPE 


WORDS 


CODE 


HULL 




0 


LOGICAL 


1 


1 


INTEGER 


1 


2 


BVTE 


1/2 


3 


REAL 


2 


4 


DOUBLE 


2 


5 


LONG 


3 


6 


COUP LEX 


4 


7 


LABEL (SPL) 




10 


CHARACTER (STRING) 


N/2 


11 


LABEL (FORTRAN) 




12 


UNIVERSAL (BATCHES ANY TYPE) 




13 



STRUCTURE 

SIflPLE VARIABLE 
POINTER 
ARRAY 
PROCEDURE 

NODE 

NULL 
VALUE 
REFERENCE 
NRnE 



NOTE: A descriptor of 0 results in an automatic natch. 
Pascal 

Pascal sets the high order bit in the paraneter type descriptor uhen 
it is generating hashed values. The renaining 15 bits are based 
on a hash of the types oF the paraneter. Only the Pascal conpiier can 
conpute the value, and the SEGflENTER nust natch the whole 16 bit value. 
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Clarification Notes on Entry Types 2 and 4 
with Respect to SPL and FORTRAN 



'ENTRY TYPE 2 "ENTRY TYPE 4 "ENTRY TYPE 2 "ENTRY TYPE 4 

SPL O.B. SPL PROC FORTRAN ItRIN FORTRRN SUB. 

TPOB 0 0 0 

5 1 1,2,3,4 1,2,3,4 



TSDB 
NUPUST 



5 

NUSDB 



TSDB 
NUPUST 



TSDB 
NUPUST 



TSDB 
NUPUST 



TPDB = Total prinary DB length in uords 
TSDB = Total secondary DB length in words 
NUPUST - Nunber of uords in "TRACE" array 
NUSDB = Nunber of words in secondary DB array 
NUO = Nunber of words in own array 
NUD = Nunber of words in data array 

1. Does not include the length of the STLT 

2. Does not include the length of the FLUT 

3. Does not include the length of any ccnnon array 

4. Includes the length of any OB-allocated fornat array 

5. fire not necessarily equal 



In general TPDB and TSDB are sunnations of storage allocated in the global 
area of the progran's data segnent. They are not, however, conplete since 
the conpilers are not aware of all storage actually allocated! The STLT 
and FLUT are exanples of this since these tables are constructed by the 
segnenter. Connon arrays also present a problen since their inclusion in 
TPDFj and TSDB night cause thei*- storage requirenents to be counted nore 
than once. 



Relocatable Object Code 
Entry Type 0 

GARBAGE 

0 1 10 
I///I NU | 



NU - Nunber of words in this 
block 



I 



I 



Entry Type 1 
SE GHENT NAME 
0 1 

I//I NU 



10 11 
I 1 



I A I /////// 1 NC 



I (VARIABLE K CHAR. SEE HC) 

I 

I 



I CHAR. NC Ml III lllll llllll 
I SEGL 
I L | SUBL 



NU - Nunber of words in entry 
block 

HL - Hash link - points to next 
entry having the sane 
hash code 

fi - Activity bit 

0 if active 

1 if inactive 
(initialize to 0) 

Note: fin inactive segnent 

inplies that all entry 
points are inactive 

NC - Nunber of characters in 
nane. (lax is 16 

CHAR. 1 - First character in 

variable field 
CHAR. NC - Last character in 

variable field 
SEGL - Segnent link - points to 
next segnent nane 
entry 

SUBL - Subprogran link - points 
to next entry having 
the sane segnent nane 

L - Last entry in list 

0 if not last 

1 if last 



Relocatable Object Code 
Entry Type 2 



OUTER BLOCK 
0 1 2 3 4 5 6 7 



I//I NU 


I 2 I 


I HL | 


I A | C I I \UI 


NC I CHAR 1 | 


I (VARIABLE i CHAR. SEE NC) ! 


I CHAR NC 


Mimimiiiiiimn 


I L | 


SUBL | 


I L I 


SECL | 


I SSR | 




SAC 1 


i RELATIVE TO 


SAI (SEE RECORD 0) I 


I F | U ] 


NUC | 


I SE | 


I TPDB | 


I TSDB | 


I NUPUST | 


I NUO/NUSDB | 


I T | 


NH | 




SAH 1 


I RELRTIVE TO SHI (SEE RECORD 0) I 


I HDU | 
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Relocatable Object Code 


Relocatable Object Code 


Entry Type I (cont. ) 

\ : i 




Entry Type 2 [cont. ) 

SUBL - Subprogran link - points to next entry 
Entry having the sane segnent nane. 

SECL - Secondary entry point list link. 


I HDU | 

; 1 




SSR - Progran unit starting PB address. 

SRC - Starting 8EILE9 address of code 
nodule 


I T | NH | 




F - Set if fatal error 
U - Set if nonfatal error 


i SRH | 




NUC - Nunber of words in code nodule. 


1 HDU | 




SE - Stack size estinate 

TPD8 - Total nunber of uords of prinary 
DB tD be allocated 


1 HDU | 

NU - Nunber of words in entry block. 

HL - Hash link - points to next entry with 
sane bash code. 

R - Activity bit. 0 if active, 1 if inactive 
outer block. 

C - reliability bit set if entry point is 
unc»llable. 

I - Privilege node bit - set if progran unit is 
to be executed in Privilege node.. 

NC - Nunber of characters in nane. Hax is 16. 

CHHR. 1 - First character in variable field. 




TSD8 - Total nunber of uords of secondary 
DB to be allocated. 

NUPUST - Nunber of uords in trace array 
(PUST) 

NHD - Nunber of uords in data array 
(FORTRAN) 

NUSDB - Nunber of uords in secondary 
DB array (SPL) 

T - Teminating bit - set if last set of 
headers in entry 

NH - Nunber of headers 

SRH - Starting address of header (relative 
to SRI) 

HDU - Header (pointer) 


CHRR. NC - Last character in variable field. 






L - Last entry in list. 

0 if not last 

1 if last 
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Relocatable Object Code 


Entry Type 3 




Entry Type 4 (cont. ) 


OUTER BLOCK - SECONDARY EHTRY POINT 






0 1 2 3 4 5 6 7 S 10 11 15 




I SRC i 


HU I 3 I 
I HL | 
IMC |//|//| NC | CHRR 1 | 




IF | Ul NUC | 
I SE | 
I TPDB | 


! (VRRIR8LE tt'cHRR.SEE NC) j 




I TSDB | 


I CHRR NC \llllllllllltllllllll\ 
I L | SECL | 
I SSR | 




I NUPUST | 
! NUD/HUO | 
I P I NP | CN | 
I TN | 


Entry Type 4 




I PRRn.1 | 


PROCEDURE 




I fwgoTDgi r g nc pRRnc. «rc ru\ 1 


0 12 3 4567 8 10 11 15 
— I — I — I — I 1 1 

NU I 4 | 

1 HL | 




!. IZr_JL:_"IL™ 1 

1 PflRn. np i 

t T [ NH | 


|fl ] C| II H| NC | CHRR.1 | 




1 SRH | 


! (VRRIRBLE # CHRR. SEE NC) i 




1 HDU | 


I CHRR.NC | IllllllllilllllillllllllllllU I 






IL I SUBL | 
IL I SECL | 




1 HDU | 


I SSR | 




1 ETC | 
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Relocatable Object Code 




Entry Type A (cont. ) 


Entry Tvoe 5 




NU - Hunter of uords in entry block 

HL - Hash link - points to next entry uith sane hash code 
R - Rctivity bit. 0 if active, 1 if inactive entry point 
C - reliability bit set if entry point is uncallabie 

I - Privilege node bit. Set if procedure is to be executed in privilege node. 
H - Hidden entry point. Set if entry point mil not be in 

library directory. 
NC - Nunber of characters in nane. flax is 16. 
CHART - First character in variable field. 
CHRR NC - last character in variable field. 
1 - Last entry in list 

0 if not last 

1 if last 

SU8L - Subprogran link. Points to next entry having the satie segnent 
Nane 

SECL - Secondary entry point list link. 

SSfl - Unit starting P8 address 

SAC - Starting (file) address of code nodule 

F - Set if fatal error 

U - Set if nonfatal error 

HUC - Nunber of uords in code nodule 

SE - Stack size estinate 

TPDB - Total nunber of words of prinary OB to be allocated. 
TSDB - Total nunber of uords of secondary 08 to be allocated. 
NUPUST - Nunber of uords in trace array (PUST) 
NUD - Nunber of uords in data array (FORTRAN) 
HUO - Nunber of uords in oun array (SPL) 
P - Parameter checker 

00 no checking. (Inplies NP undefined, FN and PRRrl's absent) 

01 check procedure type. (Inplies NP is undefined and PARM's 
absent) 

10 check procedure type and nunber of PRRH's (inplies PRRH's 
absent) 

11 check procedure type, nunber of PfiRfl r s and type of each Pflffll. 
NP - Nunber of PFWW's 

CN - Character count of PRRII's 

TN - Terminating bit. Set if last set of headers in entry. 

NH - Nunber of headers 

SflH - Starting address of header 

HOli - Header (pointer) 


PROCEDURE - SECONDARY ENTRY POINT 
0 12 3 4 5 6 7 8 10 11 1 




|._, 1 1 

NU I 5 




! HL 




I A| C |//|H | HC | CHHR. 1 




| (VARIABLE «CHfiR. SEE NC) 




chhr. nc i mi mum an 




IL I SECL 




1 S5R 




NU - Nunber of uords in entry block 

HL - Hash link - points to next entry with 
sane hash code 

A - Activity bit. 0 if active, 1 if inactive 
entry point 

C - Callability bit set if entry point is 
uncallabie. 

H - Hidden entry point set if entry point 
uill not be in library directory 

NC - nunber of characters in nane, nax 
is 16 

CHfiR 1 - First character in variable field. 




L - Last entry in list 

0 if not last 

1 if last 






SECL - Secondary entry point list link 






SSH - Unit starting PB' address 
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Relocatable Object Code 




Entry Tree 6 


Entry Type 6 (cont. ) 




INTERRUPT PROCEDURE 


NU - Nunber of uords in entry block 




f 0|1 |2 |3 |4567|S 10|11 151 
NU 16 1 
1 HL | 


HL - Hash link. Points to next entry 
uith sane hash code 

A - fictivity bit. 0 if active, 1 if 
inactive entry. 




|ft | IT |//| NC | CHRR.1 | 


IT - Interrupt procedure type nunber 

NC - Nunber of characters in nane (naxinun is 163 


| (VARIABLE It CHRR. SEE NC) I 

! : ! 

Ifl | IT |//| NC I CHRR.1 | 


CHAR 1 - First character in variable 
field. 

CHHR NC- Last Character in variable field 


I (VARIABLE » CHRR. SEE NC) ! 


IPL - Interrupt procedure link 




j CHHR. NC I ////////////////// I 


DBS - Nunber of uords of DB storage 
required. 




i IPL | 


SSA - Unit starting PB' address 




i DBS | 
t SSfl | 


SAC - Starting (file) address of code 
nodule. 

F - Set if fatal error 




I SRC | 


U - Set if nonfatal error 




IF I U| HUC I 
IT | NH | 


NUC - Nunber of uords in code nodule 

T - Terninating bit. Set if last set 
of headers in entry. 


| SRH 


NH - Nunber of headers 

SRH - Starting address of header. 




| HDD | 


HDU - Header (pointer) 




! HDH | 
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Entry Type 7 



Riloeitabll Objtct Coil 



Riloeitabll Object Colli 
Entry Type 7 feont.i 



BLOCK DATA 

0 | 1 | 2 | 3 |4567|S 10|11 15 



I III 



-I — I- 



NU 



I 7 



HL 



B I F i U NC i CHHR. 1 

BLOCK DATA HANE 



CHflR.HC \IUIIIIIIIIIIIIIIIIIIII 
80 L 



CflL 



Ulllllimilltt HC I CHRR.1 



COnnON ARRAY HUME 
CHRR.NC Mllllllllllllllllllllll 



m 

SflH 
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Entry Type 8 

PROCEDURE - SECONDARY ENTRY POINT 
0 1 2 3 4 5 6 7 8 10 11 



I ll\ 



-I--I--M- 



I 8 I 



HL 



R I CI//I H| NC I 



(VARIABLE tICHAR. SEE NC) 



CHAR. NC MlllUlllillltlllilll 
L | SECL 



P I 



HU - NUtlBER OF UORDS IN ENTRY BLOCK 

HL - HASH LINK - POINTS TO NEXT ENTRY 
UITH SAHE HASH CODE 

A - ACTIVITY BIT. 0 IF ACTIVE, 1 IF INACTIVE 
ENTRY 

C - CALLABILITY BIT SET IF ENTRY POINT IS 
UNCALLRBLE 

H - HIDDEN ENTRY POINT. SET IF ENTRY 
POINT UILL NOT BE IN LIBRARY 
DIRECTORY 

NC - NUflBER OF CHARACTERS IN NAHE. MAX 
IS 16 
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Relocatable Object Code 



CBL 



lllllllllllllin NC | CHAR.1 
C011I10N ARRAY NRHE 



CHAR.NC \IIIIIIIIIIIIIIIIIIIIIU~ 
T | NH 
SRH 



HL 



HDU 
ETC 



Nunber of words in block 



- Hash link. Points to next entry with 
sane hash code. 

A - Activity bit. 0 if active, 1 if inactive 
block. 

F - Set if fatal error. 

U - Set if nonfatal error. 

CHAR 1- First character in variable field. 

CHRR NC-Last character in variable field. 

BDL - Block data link 

■ Connon array length 



CBL 
T 

NH 
SAH 
HDU 



- Terninating bit. Set if last set of 
headers in entry. 

- Nunber of headers. 

- Starting address of headers. 

- Header (pointer) 
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Relocatable Object Code 
Entry Type 8 (cont. ) 

CHAR 1 - FIRST CHARACTER IN VARIRBLE LIST 

CHAR NC - LAST CHARACTER IN VARIABLE 
LIST 

L - LAST ENTRY IN LIST 

0 IF HOT LAST 

1 IF LAST 

SECL - SECONDARY ENTRY POINT LIST LINK 
SSA - UNIT STARTING PB' ADDRESS 

P - PARfl CHECKER 

00 NO CHECKING (inPLIES NP UNDEFINED, 
TN AND PARHS ABSENT) 

01 CHECK PROCEDURE TYPE (II1PLIES NP 
IS UNDEFINED AND PARAS ABSENT) 

10 CHECK PROCEDURE TYPE AND NUdBER 
OF PARKS. (IBPLIES PAR11S ABSENT) 

11 CHECK PROCEDURE TYPE, NUtlBER OF 
PARI1S BHD TYPE OF PARd. 

HP - NUFIBER OF PBRBS 

r>j - ruoooryrp rnnuT nr pDOJi? 

TN - PROCEDURE TYPE 



S- 20 



Relocatable Object Code 



Entry Header Fornat 



SDH >| HERDER 



HERDER 



Relocatable Object Code 
Header Ty pe 0 




Header Type 1 

PCflls 
0 1 2 3 4 5 6 7 




EACH ENTRY (EXCEPT SECONDARY ENTRY POINT ENTRIES) 
HAY DESCRIBE N> 0 SETS Of HERDERS. THE HEADERS IN 
ERCH SET MUST BE CONTINUOUS AND IH THE SflllE ORDER 
HS THE HOU LIST DESCRIBING THE SET. 

THE CODE flOOULE MAY BE PLACED IN ANY POSITION IN A 
HERDER SET. NOTE THAT IF THE CODE MODULE IS AT THE 
BEGINNING OF A SET, SRC = SBH. 



IF THE ENTRY I 
IS ASSENT. 



i NO HEADER SET, THEN NH, SBH SEOUENCE 
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l-l- 



I 



10 11 

— I 

I 1 



PBR 



I 

NC | CHAR. 1 

I 

I 



uiiiiimiiiiiiimi 



i p i 



i 



CN 



• PB' ADDRESS OF LINKED LIST OF PCBL 
INSTRUCTIONS TO BE REPAIRED - LOUER 
14 BITS USED AS NEGATIVE OISP. - BIT 0 
SET HERNS THAT UORD IS NOT A PCBL 
INSTRUCTION BUT R POINTER TO A SST 
LABEL OF "EXTERNAL' ' FORMAT - A 
LINK OF 0 TERMINATES THE LIST - BIT 1 
SET HERNS THAT THE UORD IS TO BE 
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Relocatable Object Code 



INITIALIZED UITH THE PS ADDRESS OF 
THE PROCEDURE. 



Header Type 2 



0 1 

-I 

ll\ Nil 



Relocatable Object Code 

Header Type 4 

DSDB/OUN/DATA/VALUES 
0 1 10 11 



10 11 

—I 

I 2 



///I 


HU | 


4 


LD 


B I 


IN 





INITIAL VALUES 



PBA - PB' ADDRESS OF PB ADDRESS 
TO 8E CORRECTED 



OUN/DATA VARIABLES 
0 1 10 11 15 



■ LOGICAL UORD DISPLACEMENT 
IN OUN ARRAY FOR INITIAL VALUES 

• BYTE BIT-SET IMPLIES THAT LO IS 
TYPE BYTE AND THAT THE FIRST 
UORO OF THE INITIAL VALUE BLOCK 
IS A COUNT OF THE NUMBER OF BYTES 
IN THE INITIAL VALUE BLOCK 
INTEGRATION NUMBER - NUMBER Of 
TIMES THE BLOCK OF INITIAL VALUE 
IS TO APPEAR IN THE SECONDARY 90 - 

1- >N0 DUPLICATION, 

2- >DUPUCATI0H, ETC 



ll\ 



Header Type 5 



PS' ADDRESS OF OUN VARIABLE 
POINTER TO BE CORRECTED 




PBA - PS' ADDRESS OF LINKED LIST OF 
POINTERS TO BE INITIALIZED UITH 
DB ADDRESS OF PUST (SAME LIST 
FORMAT AS FOR F0RW7 STRINGS) 
A PBA of -i Indicates uri ftx-i.ip$. 
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Relocatable Dbjtct Com 



NOTE: FILL REFERENCES TO THE POST INCLUDE THE FOUR-UORD HERDER 
THAT IS APPENDED BY THE SEGI1ENTER. THESE UDRDS ARE NOT 
PRESENT IN THE HEADER; THEY ARE AUTGHRTICALLY 
ALLOCATED RNO IHITIAUZEO 8Y THE SEGHENTER, 



Header Type 6 

GLOBAL VARIABLES 

0 1 7 8 

--I I- 

ll\ NU 

TH 

DBA I ///////// 1 NC 
CHRR.1 | CHAR. 2 



10 11 

— I 

i 6 



15 



char, nc uiiiiwmmr 



Header Type 7 
EXTERNRL VARIABLES 
0 12 3 4 5 6 7 8 10 11 



//I 



-l-H-l- 



l-l- 

NU 



TH 



HC | CHAR. 1 



CHAR. NC Ml ill I III 1 1 lllll 
DA 



PBA-P8' address of linked lists 
of instructions to be repair- 
ed;louer 8 bits of inst. used 
as neg. displacenent to next 
inst ruction; a link of 0 
terminates the list. 

II -flonitored variable bit;set 
if variable is being non- 
itored by debug. 

DR -Logical uord disp. in PUST; 
lower S bits of Hord uill be 
init. with prin.D8 address 
of variable;DA is present 
if 11=1 . 

NOTErPBA of -1 inplies null list 
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Header Type 9 

COhTON VARIABLES 
0 1 2 3 4 5 6 7 8 10 11 15 



--H-H 

in 


l-H-l 1 1 

HU | 9 I 




NUC I 


iiiiiun 


NC | CHAR. 1 j 






CHAR. 


nc \n ii mi ii mi u\ 


bi nl 


HL i 




LD | 




DA | 




PBA I I 




ML 

i 
i 


PBA 


i 






I B| til 


HL 1 




LD 




DA 




PBR 1 



Relocatable Object Code 

Header Type 8 

PRIflARY DB 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



-1-1- 



-l-l-l-l-l-l-l-l-l-l- 
NU I 8 



U!U IU I U | U |U I U I U 
0| 1 I 2 I 3 | 4 I 5 I 6 I 7 



U IU |U |U IU Ulllllllllll 
N-5| N-4I H-3| N-Zi N-1 i IIUHIIIIII 



INITIRL VALUES 



U - ADDRESS BITS 

00 IF NO ADDRESS 

01 IF NO ADDRESS 

10 IF UORD ADDRESS IN SECONDARY DB 

11 IF BYTE ADDRESS IN SECONDARY D8 

N - NUPDB 

NOTE: INITIAL ADDRESSES THAT ARE 
SECONDARY DB ADDRESSES ARE 0 

RELATIVE (I.E., THEY ARE 
LOGICAL DISPLACEMENTS IN 
SECONDARY DB). 
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Relocatable Object Code 
Header Type 9 fcont. ) 

NUC - NUMBER OF UORDS IN CDttflON ARRAY 

NC - NUI1BER OF CHARACTERS IN COhTON 
NA11E- IF BLANK COUHON 4 COB' 

DA - LOGICAL UORD DISP. IN PUST - LDUER 
8 BITS OF UORD UILL BE INIT. UITH 
PRIfl. DB ADDRESS OF VARIABLE - NOTE 
DA IS PRESENT IF H = 1 

B - BYTE BIT 

0 IF THE PRIHHRY DB POINTER TO BE 
ALLOCATED AND INITIALIZED AND LD 
ARE OF TYPE UORO 

1 IF TYPE BYTE 

n - IIONITORED VARIABLE BIT - SET IF 
VARIABLE IS BEING IIONITORED BY 
DEBUG 

NL - NUMBER OF ADDRESS LISTS FOR 
VARIABLE 

LD - LOGICAL DISPLACEMENT OF VARIABLE 
IN COnilON ARRAY 

PBA - PB' ADDRESS OF LINKED LISTS OF 
INSTRUCTIONS TO BE REPAIRED 
LOUER 8 BITS USED AS NEGATIVE 
DISPLACEMENT TO NEXT IHSTRUCTIOH 
A LINK OF 0 TERMINATES THE 
LIST 

PBA = -1 INDICATES HO FB-UPS 



PBR 
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Header Type 10 
LOGICAL UNITS 
0 

l-l 

I 



10 | 



BIT HAP - BIT HAP OF LOGICAL UNITS 
REFERENCED; BIT 0 
CORRESPONDS TO LU 0, ETC. 
(1 LESS THAN OR EQUAL TO LU 
LESS THAN OR EQUAL TO 99) 



Header Type 11 



FORMAT STRING 

0 10 11 15 

l-l — I I 

I//I NU I 11 I 
| | 

I P9A j 

I 1 

NC I 

I- -I 

I CHAR, 1 | CHAR. 2 I 

I — I 

I • I 

! • I 

i I 

i_ char, nc uiiiimniiiiin 

m - PS' ADDRESS OF LINKED LIST OF 
POINTERS TO BE INITIALIZED 
LOUER 14 BITS OF WORD USED 
AS NEGATIVE DISPLACEMENT TO 
NEXT POINTER - BIT 0 SET 
MEANS THAT THE POINTER IS TO 
BE TYPE BYTE - A LINK OF 0 
TERMINATES THE LIST. 
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RL File Fomat 



0| 


LID 


10 


LOADER ID 


01 


11 


FL 


|1 


FILE LENGTH (IN RECORDS) 




21 


NS 


12 


NR. SECTIONS 




3| 




|3 






4j 

si 


SAUL 


|4 

15 


S.A. EXTERNAL SET LIST 




61 




16 




11 


7| 




I? 




1 
1 


101 




IS 




1 
1 


111 




IS 






121 




110 







RECORD 

0 



NS | 



I FREE MAP 
I HS-1 



NOTE: UNINITIALIZED FIELDS ARE 

RESERVED FOR FUTURE USE AND 
SHOULD BE ZERO. 



IRVAILABLE 



33 S.A. HASH LIST 0 



HL 1127 S.A. HASH LIST 94 
94 
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Relocatable Object Code 



Storage Manaqenent 



FILE SPACE IS MANAGED IN TERMS OF 32 UORDS BLOCKS (4 BLOCKS PER 128 UORD 
RECORD). 



FREE SPACE (BLOCKS) IS ACCOUNTED FOR IN A BIT BAP, UHICH IS PARTITIONED INTO 
RECORDS (2K BLOCKS PER SECTION). R 0 INOICATES THAT A BLOCK IS USED, A 1 
INDICATES THAT IT IS FREE. 



FILE SPACE IS ALSO PARTITIONED INTO 512 RECORD SECTIONS (64 MAX. SECTIONS, 
2K BLOCKS PER SECTION, 1 MAP PER SECTION). THE NUMBER OF SECTIONS IN A FILE 
IS MS=(FL*S11) 4 LSR(9). THE FIRST NS RECOROS FOLLOWING RECORD 0 (RECORDS 1 
TO NS) ARE RESERVED FOR THE SECTION MAPS. 



H COMPLETE FILE ADDRESS UOULD HAVE THE FOLLOWING CONFIGURATION: 



0 1 2 3 4 5 6 15 16 
| 1 

1 I SECTION | 



26 27 3- 

— I 

I DISPLCHT 



FILE (UORD) ADDRESS 
DOUBLE UORD 
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Entry Point Directory 



I HL 



LINK 
USED 



Sill HI 1 1 
Mlllllll 



->| LINK 
| 

I USED 
| 

i 
I 

I 
I 
I 

I 

Mlllllll 
Mlllllll 



o 

USED 



//////// 
//////// 



THE DIRECTORY IS PARTITIONED INTO 95 HASH LISTS (SAME HASH FUNCTION AS USD; 
EACH HRSH LIST IS A LINKED LIST OF RECORDS. 



EACH RECORD CONTAINS A SUCCESSOR LINK (RECORD #) AND A USED SPACE COUNT. A 
LINK OF 0 TERMINATES A LIST. WHEN A RECORD IS VOID OF ENTRIES (USED=2), ITS 
SPACE IS RETURNED TO THE FREE STORAGE AREA. 
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Relocatable Object Code 




Typical Directory Entry 


Procedure Information Block 


0 12 3 4567 8 15 


0 15 


|...| — | — | — | 1 

I S | U | I NC | CHRR. 1 




NU INFO | 
1 NU CODE j 
1 it ENTRY POINTS | 




! CHAR. NC | lllllillllllllllllllll 1 


! 1 i 

1 CODE HODULE | NUC 




! S.A. INFO BLOCK 




1 | 




\ S.fl. ENTRY 




1 EXTN LINK 1 




1 F | U | m CODE 








1 LC 1 NP | CN 

1 TN 




! TPDB | 
j TSOB | 




! parii. 1. 




! NUSDB i NU 
1 HEADER ! 




I PARH. NP 








S - SECONDARY ENTRY POINT BIT - SET IF 
THE ENTRY POINT UAS ORIGINALLY R 
SECONDARY ENTRY POINT. 








U - UNCALLABLE BIT - SET IF ENTRY POINT 
IS UNCALLABLE. 








I - PRIVILEGED I10DE BIT - SET IF CODE 
HODULE IS TO BE RUN IN PRIVILEGE (10DE. 




1 HEADER i 




LC is (0:2)... Level of Checking 
0 = No checking 




1 -1 | 




1 >= Check for procedure type 

2 >= Check for 8 paraneters 

3 >= Check for pararieter type 
NP is (2:6) is S paraneters 




ALL HEADERS FDR THE PROCEDURE ARE APPENDED TO THE INFO BLOCK. THE 
HEADER SETS (EXTERNAL LISTS) ARE LINKED BY INCREASING FILE 
ADDRESS; A LINK OF Z17777777777D TERHINATES THE LIST. 
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Relocatable Object Code 






Headers 








0 1 2 3 4567 8 10 11 15 








| — |— -| — | — | 1 , 

NU | 1 








I F | U | NU CODE 








i S.A. INFO BLOCK 








; S.A. ENTRY 








P8A 

I S | U | I |///| NC I CHAR. 1 








I CHAR. NC UIIIIIHIllllllllllllll 








IP! NP | CN 








i TN 








! PRRO. 1 








I PARd. NP | 








F - SET IF FATAL ERROR 

U - SET IF NON-FRTAL ERROR 

S - SATISFIED BIT - SET IF EXTERNAL IS 

SATISFIED UITHIN RL. 
U - UNCALLABLE BIT 
I - PRIVILEGED BIT 








ALL HEADERS ARE THE SANE AS IN A USL EXCEPT FOR THE PCAL HEADER. 
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Prepared Object Code 



Prepared Object Code 



01 FLAGS I 0 
I I 

11 NS |1 
I I 

21 GS |2 
I I 

3| m |3 
I ! 

4| sns i 
I 1 

5I ISS 15 
I 1 

61 IDL3 |6 
| 1 

7| maxd |? 
I 1 

101 SHE |8 
| 1 

111 SSEG |9 

I- I 
121 SADR |10 

I I 

13| SftSTLT 111 

I I 

141 SAFLUT 112 

I I 

151 SAX 113 

I I 

161 SSTT |14 

I I 
17| SATC |15 

I I 

20 1 SBPMAP |16 

| 1 

211 SflSI 117 
| 1 

22I FLAGS2 |19 
| 1 

23 1 CKSUM 119 
I I 

24| 120 
| 1 

251 121 
| 1 

26| |22 
| 1 



CHAPTER 10 PREPARED OBJECT CODE 
Proqran File Fomat 



NUMBER OF CODE SEGMENTS 
GLOBAL SIZE (OB TO QI) IN UORDS 
GLOBAL AREA RECORD It 

SEGMENT SET RECORD » (EACH SEG. STARTS IN NEU RECORD) 

INITIAL STACK SIZE IN UORDS 

INITIAL DL SIZE IN UORDS 

MAX. DATA SEGMENT SIZE (DL TO Z] IN UORDS 

ENTRY POINT LIST RECORD * 

STARTING SEGMENT 8 

PRIN. ENTRY PT PB ADDRESS 

DB ADR. OF STLT (-1 IF NO STLT) 

(STLT=Segnent Length Table) 
DB ADR. OF FLUT (-1 IF NO FLUT) 

EXTERNAL LIST RECORD It 

PRIN. ENTRY PT SST It 

STARTING ADDRESS OF TRAPCOH' 

STARTING RECORD OF PMAP INFO 

STARTING RECORD OF SYtlBOLIC ITEMS 

TOTAL CHECKSUM OF ALL SEGMENTS 

NOTE : ALL UNUSED UORD ARE RESERVED FOR 
FUTURE USE AND SHOULD BE SET TO 
ZERO. 
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Prepared Object Code 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|-| — — | — | — | — | — I — I — I — | — | — | — | — I — I 
I F I U IZ IP |BB|IH|PM| | | MRI///I DS| PH 



F - FATAL ERROR IN PROGRAM 

U - NON-FATAL ERROR IN PROGRAM 

Z - ZERD UNIT DL P-REfl 

P - SET IF ANY SEG IS PRIVILEGED MODE (IF NOT SET NORMAL= 
NONPRIV MODE) 



CAPABILITIES 



ACCESS TO 

GENERAL 

RESOURCES 



BATCH ACCESS (9) [BB] 
INTERACTIVE ACCESS (8) [IA] 
PRIVILEGED MODE (7) [Pn] 



nuLiirti R±na \tj L i irt j 

EXTRA DRTA SEGMENT (2) [DS] 
PROCESS HANDLING (1) [PH] 



Progran File Fomat (Cont.) 
I I 



CST I CST 
o I 1 



CST Mill II 
n Ml I III 



P I S I SL 
I I o 



PIS! SL 
I I n 



CST REMAPPING ARRAY 



SEGMENT DESCRIPTOR ARRAY 



P-PRIVILEGED MODE 

S-Segnent STT fomat: 0=> old fornat, 1=> neu (extended) fomat 
N=NS -1 

K=28 t (NS *1) S. LSR (1) 

L=((28 t NS t (NS * 1)S,LSR(1) * 127)/128)128 - 1 
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Prepared Object Code 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



l-l-l-l-l-l-l-l-l-l- 
I T | K | 



-I — I — I — I — I 



G.OO.OO 
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T - PATCH AREA EXISTED IN ALL CODE SEGMENTS 
K - CHECKSUM VALID 



CST Renappinq Array 

CONTAINS THE LAST CST NUMBERS ASSIGNED TO THE SEGMENTS; 
INDEXED BY SEGMENT NUMBER. UHEN A PROGRAM FILE IS 
PREPARED, THE ARRAY IS INITIALIZED TO 0, 1....N. 
THIS ARRAY IS USED TO RE-ESTABLISH INTRA-PROGRAM 
LINKAGE UHEN THE PROGRAM IS LOADED. 



Seqnent Descriptor Array 



CONTAINS THE SEGMENT LENGTH AND A FLAG INDICATING IF THE 
SEGMENT IS TO BE LOADED IN PRIV. MODE. INDEXED BY 
SEGMENT NUMBER. ALL SEGMENTS BEGIN QH A RECORD BOUNDARY. 
THE NUriEER* OF RECORDS FOR a"gWEN SEGMENT IS (SL * 127) 
& LSR(7). THE RECORD NUMBER, SAS, OF SEGMENT N IS 

SAS:=0 

FOR 1=0 TO N-1 
BEGIN 

SBS:=SBS t (SL(I) ♦ 127)J.LSR(7) 
END 



Global Area Fomat 



A SET OF RECORDS CONTAINING THE INITIAL VALUES FOR THE 
GLOBAL AREA OF THE DATA SEGMENT. THIS SET BEGINS AT 
RECORD SAG (UORD 3) AND CONSISTS OF (GS * 127) S. LSR(7) 
RECORDS. 
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Prepared Object Code 



0 7 8 15 

— I — I 

///INC I CHAR 



CHAR K.MI III III 



STT • | SEG * 

-I- 

LCI NP | CN 
-I 

TN 
PARR 1 



I LIST TERMNATER 



IX (0:2) = LEVEL OF CHECKING 

0 = NO CHECKING 

1 >= CHECK FOR PROCEDURE TYPE 

2 >= CHECK FOR * PARHRETERS 

3 >= CHECK FOR PARARETER TYPE 

MR = NUHBER OF REFERENCES 

NP (2:6) = NUIfSER OF PARARETERS 
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Prepared Object Cede 



Entry Point List 



1 1 ll\ NC I CHAR 1 



CHRR NC \lllll I III 



P.B. ROR 
STT # 



////I NC I CHRR 1 



CHAR NC I/////////I 
P.B. ADR 
STT # 

0 | LIST TERMNRTER 



NOTE THAT THE ENTRY POINT LIST flUST MEDIATELY 
FOLLOU THE EXTERNAL LIST. 
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Prepared Object Code 



Code Seqnent jjith Patch Area 



Prepared Object Code 
PflAP Information 



PATCH 
RREA 



PROC-RRH | 4-UORD PROGRAR NAtlE 
NAE1E | 



8-WORD SECI1ENT NARE 



SEBRENT 
HARE 



II 

CHECKSUd 
PREP TIRE 
PATCH TIRE 



PATCH 
RREA 



1-UORD UNUSED 

1- UORD CHECKSUd 

2- UORO PREP TIRE 
2-WORD PATCH TIRE 

1-UORD PATCH AREA LENGTH 



I APO 



PROP Type Table 



PTTL 
LPRO 
LPR1 



PflilP TYPE TABLE 



SFGRENT PHAP POINTERS 



ACTUAL PRBP DflTllll 



TYPE TABLE LENGTH 

LENGTH OF PRAP RECORD TYPE 0 

LENGTH OF PRAP RECORD TYPE 1 



LPRn | LENGTH OF FRAP RECORD T*PE n 

NOTE : n = PTTL - 2 



COO. 00 
10- ? 



0.00.00 



Prepared Object Code 



Prepared Object Code 



PfflP Records 

Type 0 Segnent PnBP Record 

0123466789012345 
Ol KC I char 1 



iii I nun i 



STT LEN I SEC- HUn 
SEC- LENGTH 



Type 1 Procedure PflRP Record 

0123456789012345 
11 HC I char 1 \ 



Ml llllll llll III 



mi/ii/iiiiiii/i/ii/i/iiiii/iu 

SB OF COOE 



CODE LENGTH 
PRinflRY ENTRY POINT I 



COBOL TOOL BOX ID 
LINK 



TOOL BOX PROCEDURE ID 
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' Prepared Object Code 



SI Pile Fomat 



Ol LID |0 
| 1 

1| FL 11 FILE LENGTH (IN RECORDS) 

2! EL '|2 EXTENT LENGTH (IN RECORDS) 
| 1 

31 |3 

I I 

4! NSEG 1 4 * SEGMENTS 
I 

15 



5 
6 

7 

10 

1 

111 NRT 19 * REFERENCE TABLE ENTRIES 
-I 



FRTL 17 S.fl. OF FREE R.T. ENTRY LIST (-1 IF NONE) 

1 

IS 



121 



131 NS 

I 

141 



[10 

11 # SECTIONS 
12 



41| HLO 

I 

I . 



177IHL94 



NOTE: 

SHADED AND UNINITIALIZED FIELDS ARE 
127 RESERVED FOR FUTURE USE AND 

SHOULD BE ZERO. HL = HfiSH LIST. 
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Type 2 Secondary Entry PHHP Recor-d 

0123456789012345 
2| NC I char 1 



char NC Mill I II III llll I 



HMIilillllllllllitllllllilllll 
SECONDARY ENTRY POINT ADDR 
NUflBER OF ENTRY POINTS 



H : HIDDEN ENTRY FLAG 
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Prepared Object Code 
SL File Fomat (Cont.) 



I 

RECORD I 
0 I 



RECORD I < — REFERENCE TABLE POINTERS 
1 I 
I 



FREE [IBP | 
0 I 



I 

I FREE tlAP I 

I NS-1 I 

I I 



I 
I 

AVAILABLE I 
I 
I 
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Prepared Object Code 



Storage Management 



FILE SPACE IS MANAGED IN TERMS OF 128 UORD BLOCKS (1 BLOCK PER 128 UORD 
RECORD). 

FREE SPACE (BLOCKS) IS ACCOUNTED FOR IN R BIT «RP, UHICH IS PARTITIONED INTO 
RECORDS (2K BLOCKS PER SECTION), A 0 INDICATES THAT A BLOCK IS USED; A 1 
INDICATES THAT IT IS FREE. 

FILE SPACE IS ALSO PARTITIONED INTO 2048 RECORD SECTIONS (16 MAX. SECTIOHS, 
2K BLOCKS PER SECTION 1 I1AP PER SECTION). THE NUnBER OF SECTIONS IN R FILE 
IS NS=(FL » 2047) 1 LSR(7). THE FIRST NS RECORDS F0LLOUING RECORDS 0, 1 
(RECORDS 2 TO NS*1) ARE RESERVED FOR THE SECTION HAPS. 

IF THE SECTION MAPS SPECIFY HORE SPACE THAN IS POTENTIALLY AVAILABLE, THOSE 
RECORDS BEYOND FLIfllT ARE HARKED AS "USED". 



Entry Point Directory 



I HL I- 



LINK |->— • 



I USED 



I ///////// 1 
Mill III ll\ 



>| LINK |->- 
I I 

I USED | 
I— I 

I i 

I I 

| 1 

Mill II II l\ 

Miiiimn 



I USED | 



mi ilium 
Milium] 



THE DIRECTORY IS PARTITIONED INTO 95 HASH LISTS (SAME HASH FUNCTION AS USD: 
EACH HASH LIST IS A LINKED LIST OF RECORDS. 

EACH RECORD CONTAINS A SUCCESSOR LINK (RECORD «) AND A USED SPACE COUNT. A 
LINK OF 0 TERMINATES A LIST. UHEN A RECORD IS VOID OF ENTRIES (USED=2), ITS 
SPACE IS RETURNED TO THE FREE STORAGE AREA. 

THE HASH LIST HEAD POINTERS (HL IN THE DIAGRAM ABOVE) ARE IN RECORD 0 UORDS 
*41 TO Z177. 



Prepared Dbject Code 



Typical Directory Entry 



0 1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 
/III U PI NC | CHAR 1 



CHAR NC 
STT # 
LC | NP 



Mllllllllllllllilllllllllllllll 
I SEG * 



I 

TN 
PARM 1 



LC is (0:2).. .Level oF Checking 

0 = No checking 

1 >= Check for procedure type 

2 >= Check for tt paraneters 

3 >= Check for paraneter type 
NP is (2:6) is * paraneters 

P - 0= Not permanently allocated 
1= Pernanently allocated 

U - Uncallable bit - set if entry 
point is uncallable. 
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Prepared Object Code 



Code Sequent Linkage Structure 



I EXTERNAL LIST I 



EACH CODE SEGMENT OCCUPIES AN INTEGRAL NUMBER OF RECORDS. THIS BLOCK OF 
INFORMATION CAN BE SUBDIVIDED INTO THREE TABLES: THE CODE SEGMENT PROPER, AN 
STT SEGMENT MAP ARRAY, AND AN EXTERNAL UST. 



STT HHP ARRAY 

A 1 BYTE X 256 BYTE ARRAY. IT IS INDEXED BY STT NUMBER AND RETURNS (IF THE 
STT CORRESPONDS TO AN EXTERNAL OF THE SEGMENT) THE SEGMENT NUMBER OF THE 
EXTERNAL AND 255 OTHERUISE. THIS ARRAY IS USED WHENEVER THE SEGMENT IS 
LOADED AND IS UPDATED WHENEVER THE SL IS BOUND BY THE SEGMENTER. 



EXTERNAL UST 

R SYMBOLIC LIST OF THE EXTERNALS OF THE SEGMENT. EACH ENTRY CONTAINS 
INFORMATION ABOUT THE EXTERNAL: PARAMETER CHECKING LEVEL AND PARAMETER 
MATCHING INFORMATION, m Trie SED9MT WnSK mt STT lertw IF THE EXTERNAL 
IS SATISFIED UITHIN THE SL, 
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Prepared Object Code 

Code Seqnent Structure (Cont.) 

0 1 2 3 4567 8 15 
l-l-l-l— -I 



CODE SEGMENT 



SI/I/I/I NC | CHAR. 1 



CHAR. NC MIIIIIIIIHI 



STT II | SEG. It 
P I NP | CN 



TN 
PRRM. 1 



S - SATISFIED BIT - SET IF EXTERNAL 
IS SATISFIED UITHIN SL 



I FkTFRNAL LIST TERMINATOR 



G.0C.00 
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Prepared Object Cod* 



Reference Table Structure 



FOR EACH SEDHENT THERE IS A REFERENCE THBLE ENTRY OF 32 UORDS. THE REFERENCE 
TA81E ENTRIES ARE PACKED FOUR TO A RECORD. THE RECORDS CONTAINING THE 
REFERENCE TABLE ENTRIES ARE LISTED IN RECORD 1. THE RECORD CONTAINING 
REFERENCE TABLE ENTRY N IS REC 1 (N.(0 : 14)); THE FIRST UORD OF THE ENTRY IS 
REFTAB (M. (14 : 2) & LSL (5)). 

UHEN A SEGHENT IS DELETED, THE REFERENCE TABLE ENTRY CORRESPONDING TO THE 
SEGMENT IS RELEASED. THESE FREE ENTRIES ARE LINKED TOGETHER IN A LIST; THE 
SEGHEHT It IS USED AS A LINK AND IS PLACED IN THE FIRST UORD OF THE ENTRY. 

UHEN- A SEGMENT IS ADDED IT IS ASSIGNED A SEGHENT HUHBER (0 LESS THAN/EQUAL TO 
N LESS THAN/EQUAL TO 2E4); THE HUHBER IS THAT OF THE FIRST FREE REFERENCE 
TABLE ENTRY, OR, IF HONE ARE FREE, THE NEXT AVAILABLE REFERENCE TABLE ENTRY 
(CAUSING SPACE ALLOCATION FOR THE ENTRY). 



Prepared Object Code 



Reference Tab le (256 Nxihun Entrieti 



R.T. REC. 
->l E 



63 I 



SLSEGf LP.G: 
= 0 



TYPICAL ENTRY 

0 12 3 4 5 6 7 8 9 

-H-H-l-l-l-H 

P|N | SEGHENT LENGTH 



(FILE REC1) (1 SECTOR) 

SEG. NAME -16 BYTE ARRHY 
UITH HQ CHARAC- 
TER COUNT AND 
TRAILING BLANKS 
ADDED. 

REF.nAP -256 BIT ARRAY 

(INDEXED BY SEGS); 
BIT SET IF SEG IS 
REFERENCED DIRECT- 
LY OR INDIRECTLY. 



SEGHENT DELETED 
EXTERNAL SATISFIED 
PERMANENTLY ALLOCATED 
CORE RESIDENT SEGMENT 
APE SEGHENT 
PRH.INST. IN SEGHENT 
SLSEGF LAG 
PATCH FLAG 
CHECKSUn FLAG 



SEG STT IS IN 
OLD FORHAT 
1 => SEG STT IS IN 
NEU FORHAT - 
EXTENDED CSTS 



SEGHENT ADDRESS (REC. «) 
« REC'S FOR SEG. I EXTN. LIST 
F|SL/I/|A|C|XI/I/I » ENTRY PTS. 
SAPHAP 
SASI 

TIKI 

SI LENGTH 



X 
0 
1 
2 
3 
4 
5 
6 
7 
10 



REFERENCED SEGHENTS 
BIT HAP 
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Prepared Object Code 



Code Seqnent Uith Patch Area 



PATCH 
AREA 



Patch Area (Cont.) 



SEGHENT 
NAHE 



// 

CHECKSUM 



PREP TIHE 
PATCH TIHE 



PATCH 
AREA 



g-UORO SEGHENT NAHE 

1 -UORD UNUSED 

1- UORD CHECKSUM 

2- UORD PREP TIHE 
2-UORD PATCH TIME 

1-UORD PATCH AREA LENGTH 



G.00.00 
10- 18 



Prepared Object Code 
PMAP Information 




PMAP Type Table 



PTTL 
LPRO 
LPR1 



PHAP TYPE TABLE 



ACTUAL PHAP DATUM 



TYPE TABLE LENGTH 

LENGTH OF PHAP RECORD TYPE 0 

LENGTH OF PHAP RECORD TYPE 1 



LPRn | LENGTH OF PHAP RECORD TYPE n 

NOTE : n = PTTL - 2 
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Prepared Object Code 



PnRP Records 

Type 0 Sesnent PflfiP Record 



0123456789012315 


1 ? 1 Mr 1 fhar- 1 1 


1 01 NC | char 1 | 


i charllC \lllllltllllllti\ 


i rhar Uf I [ t 1 1 i 1 1 1 1 1 1 f t 1 f\ 

\ cnar m. M I II 1 II 1 1 1 1 1 II l\ 


WIIIIIIIHIIIIIIIIIIIIIIIIIlin 


1 STT LEN | SEG HUH 


I SECOHDRRY ENTRY POINT P.DDR I 


1 SEG LENGTH I 


1 NUflBER OF ENTRY POINTS | 


Procedure PIWP Record 
0123456789012345 
I 1 1 NC I char 1 I 


H : HIOOEN ENTRY FLAG 



Prepared Object Code 

Type 2 Secondary Entry PtlflP Record 

0123456789012345 



charNC \lllllimilllll\ 

Sfl OF CODE 

CODE LENGTH 

PRIHfiRY ENTRY POINT flDDR [ 

COBOL TOOL BOX ID i 

LINK j 

TOOL BON PROCEDURE ID ! 
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CHBPTER 11 LOADER 
nPE Loader 



The loader is a systen process which Mill do loads sequentially. If a process 
needs code to be loaded, it mil get the load process' SIR, fill loader con- 
nunication table, and then auake the loader. Upon conpletion, the loader Mill 
return its status through the loader connunication table, and then activate 
the Malting process. 



Loader Seqnent Table Overvien 

Loader Segment Table consists of two DST's. The nam one is DST Z22 (LST). 
The other DST (XLST) has its DST nunber stored in SYSGLOB Z226. 



PRinfiRV DB RRER 



DBt2 ->| 



LOWER COMUNICATION 
I TABLE 



I 

I- 

DB*0 ->| 
I 



Z I 



SBUF (128 uords) 
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Loader 

KLST Overieu 
98 



PRIIWRY DB BRER 



SBUF (128 uords) 



The above DST's has exactly the sane prinary DB area so that directory entry 
handling procedures can be used on both OST'S. XLST is the LST extension and 
is used to store the extension entry only. Uhen a extension entry is needed, 
it is copied into the LST to elininate frequent EXCHANGEDB. Note that XLST is 
capable for any types of entries. It is used for extension entry only for 
nou. Also, sone of the prinary DB's in the XLST are not used. They are there 
just for the consistency. 
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Loader Sequent Table Prinary DB 



0 


3DIR 


1 


DIR LEN | 


2 


*LCI I 


3 


EKTP 


4 


EHTP1 


5 


ENTP2 


6 


ENTP3 


7 


8SBUF 


10 


SI 


11 


SJ 


12 


SK 


13 


SL 


14 


sn 


15 


SN 



161 

I- 
171 

I- 
201 

I- 
211 

I- 
22! 

I- 
23| 



SO 
SR 



24|HDFULIHK(TYPE 0) 
| 



| 

jHDFULINK(TYPE 8) 



I- 

|HDBKLINK(TYPE 0) 



I- 



HDBKLINK(TYPE 8) 
LCT 



ENTPn : PDIHTERS POINT TO THE CURRENT ACCESSED ENTRY. 

SBUF : UTILITY BUFFER. USUALLY CONTAINS PROGRAN FILE RECORD 

0 INFORHRTION. 
SI ST : UTILITY DB RELATIVE VARIABLES. 
HDFU LINKS : HEAD OF FORUARD LINK FOR EACH TYPE. 
HD6K LINKS : HEAD OF BACKUARD LINK FOR EACH TYPE. 



Directory Entries 



0| 1| 2| 3| 4| 5| 6| 7| 81 9110111 |12|13|14|15 



-l-l-l-l-l-l-l-l-l- 
FORUHRO LINK 

BACKUARD LINK 

LENGTH 



-l-l-l-l-l- 



I 0 
GARBAGE 



0 i 1| 21 31 4| 5| SI 71 S| 9|10|11|12|13|14|15 
FORUARD LINK 



BBCKUARD LINK 



GBRBBGE(O) 



SL FILE(1) 



LENGTH 

I 1 
FILE DISC ADDRESS 



FILE PV INFO 



# ALLOCATED SEG 



I # SEGUST ENTRIES 



SEG ARRAY ( 16 UORDS ) 



LOG SEG NUMBER I |A It IX 

REFERENCE COUNT 
PHYSICAL CST NUNBER 



SEGUST ARRAY 
3 UORD ENTRY 
PER ALLOCATED 
SL SEG 



G.00.00 
11- 3 



G.00.00 
11- 4 



Directory Entries (Cont.) 



0| 1| 21 3| 4| 5| 6| 7| 81 9110111 |12|13|1«|15 



P IB 



FORURRD LINK 
BBCKUflRD LINK 
LENGTH 

I LIB | 

FILE DISC ADDRESS 



CSI BLOCK INDEX 
SEBW DST 
* PROCESS SHARING 
D SEC IN PROGRRn FILE I It SLINFO BRER 
PV FILE INFO 
TRACE EXTERNAL A LABEL 
SL SEARCH SEQUENCE 
SL FILE DISC ADDRESS 



LIB SEC ARRAY (16 WORDS) 



I PSEHIAP 


SIZE | 


I LIB LOG SEG 


I SL INFO INDEX j 


] LIB LOG SEG 


I SL INFO INDEX | 




I LIB LOG SEC 


I SL INFO INDEX I 
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BACKUBRD LINK 
LENGTH 



A I 



FILE DISC ADDRESS 

LOAD PROCESS STATUS 



0| 1| 2| 31 4| S| 6| 7| 8| 9|10|11I12|13!14|15 
.-|-|..|-|-|-|--|-|--|--l-|--|--|-|-|- 
FORURRO LINK 



P I 



BACKWARD LINK 
LENGTH 

I 

PIN 

FILE DISC ADDRESS 



PROGRRn 
FILE (2) 



I SL INFO AREA 
> 19 WORD PER 
I EACH SL FILE 
I 
I 

/ 



PSEGtlAP 
ARRAY 



Directory Entries (Cont.) 



01 1| 21 3| 4| 5| 6| 7| 8| 9110111 |12|13|14|15 
-I-I-I-I-I--I--I-I--I-I--I-I-I-I-I- 

FORWARD LINK 



LDHDED(E) 



SHARER(6) 



Directory Entries [Cont.) 



0! 11 21 31 4| 51 6| 7| 81 9110111 |12|13|14|15 
■ .|.-|-|-|-_|__|._|._| H __ M ..|__ 



FORURRD LINK 
BACKUARD LINK 
LENGTH 

I 

FILE DISC ADDRESS 



LORDINGO) 



Ol 1| 21 31 4| 51 6| 7| 8| 9110111 |12|13|14|15 



-I-I-I-I-I-I-I-I-I--I- 



FORWRRD LINK 
BACKWARD LINK 
LENGTH 



-I-I--I--I- 



P I 



I 



FILE DISC ADDRESS 



WAITING PIN 
UNUSED 



UAITERM 
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Directory Entries fCont 



0) 1| 2| 3| 4| 5| 6| 7| S| 9|10|11 112|13|14|1 
■ |..|..|..|..|..|..|..|-.|._|..|._|„|..|. 



FORWARD LINK 
BACKWARD LINK 
LENGTH 
I UB | 
PIN 
EXTENSION ID 



LOAOPROC COUNT! LOADPROO/LOG SEG#(RLLOCBTEPROC 
PLRBEL 



« CHAR IN NBBE 



PROCEDURE NfiflE 

I S SL INFO ARER 



SL INFO RREB (19 WORDS PER SL INFO ENTRY) 



BCSTREFSIZE 

I hcstidxo) 



IN I 



I niSTIOX(n) 



£XTENSIDH(7) 



> HCSTREF RRRRY 
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Loader 



Loader 



Directory Entries (Cent .J 



01 11 21 31 4| 5! SI 7| S| 9|10|11|12|13|14|15l 
-I--I--I-I-I-I--I--I-I-I--I-I--I--I--1--I LOBOPROC 

Fomwra link j nasTES(8) 



83CKUBRD LINK 
LENGTH 



• SLID ENTRIES 



» ACTIVE LOBOPROCS 



SYGLCB extension area + V2 contains OST nunber of cache 
BUCKETSIZE = £52 



Caere ?aT3 Sgq-e- 



1| HIT JKWTE* 



EXT ISX TABLE (16 UOROS; 



HISS COUNTER I 
9UCKET 0 I 



BEST I0» TABLE (16 UOROS) 
SLID(1) 



I 

-I 

I \ 
-! I 

I ! REFERENCED 
> Si RRR8Y 



SLIO(h) 



I WOT LOGSEG SIZE 



LOG SEG • | SLID INOEX(I) 

REFERENCE COUNT 



LOG SEG « i SLID INDEX (n) 

REFERENCE COUNT 



-I \ 
I I 
-I I 

I I 
-I I 

I I fICST LOGSEG 
> BRRBY 

I I 2 UORDS PER 
-! I ENTRY 

I I 
-I I 

! I 
-I / 
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4»S4« 8UCKEISIZE i 

I 

4*95" 6UCKETSIZE -I I 



Length of I 
SLCIR1 -1 | 



LENGTH GF 
SJIS2 • 1 



Ftost recently referenced systen SL 
directory entry frtsn this SL directory 
bucket 



I Second nost recently referenced entry 



I LENGTH CF | 
I SLDIRti * 1 | 

BUCKET) SLDIRN | Hth tiost recently referenced entry;if 

SIZE-11 1 not conplete then indicates end of 

DLC'iet 

Bii bucket yards are initialized to BUCKETSIZE +1, indicating 
no entries. 
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Lo ader Connumcation Table (LCT) 



Fom Inconing to loader f Load/Allocate Proqran) 



0! 1! 
-I--I 
CUD I 



21 31 4| 51 61 7| !! 9|10|11|12|13|14|V 



-l-l-l-l-l-l-l-l- 



ua i niLDi li \iiiiiiiiiiiiiimumi 
— -I-I-I- ■ 



PIN 



UBITER PCB INDEX 

IBflllSIPBI J BR | IDSIPH 
I-I--I-I— -l-l-l-l- 

GROUP 

mi 

ACTJnt 

KB1E 
W INfG 



G.00.00 
I 1 - 1* 



CUD'loader end 
O=lo*d prgn 
1=load prcc 
2=alloc prog 
3=alloc proc 

UB=Ubrary 
3earch 
0=SYS 
1=PUB 
2=GS0UP 



n=NQNPRiv nooE 
10= LOAD DOBBIN 
L-LORD flflP RE9. 



USER CBPSBILITY 



Fern Inconing to Loader (Load/Bliocate Procedure) 



01 1 1 21 3| 4| 51 6| 71 8| 9|10|!1 |12H3i!4 
■ -l-l-l-l- ■ " 



CUD | LIE | IIILDI L| lillHlllllllliimUIII 



-I- 



PIN 



« CHAR IN NOTE 



PROCEDURE NBtlE 



UBITER PCB INDEX 



IMIIfllPni |m| IDSIPH 
-I-I--I-I I-I--I--I- 



CBO'loader end 
O=load prgn 
1=load proc 
2=aUoc prog 
3=alloc proc 

UB=library 
search 
0=SYS 
1=PUB 



fl=NONPRIV PK»E 
LO=LOflO DOMAIN 

l=lo»d bbp reo. 



USER CBPBBILITY 
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Loader 



Loader 



Forti Returned f Mo Error) 



0 |H |Hf! STARTING SEGflEMI NWIBER 

I 

1 ! 0 



3 I 

I- 
* I 



S | TRACE LUBEL (IF TRUCE) I 
I " I 



fom Returned (Error Occurred) 



0 I 



FILE SYSTEM ERROR « 



LOBOER ERROR * 



Logical Siamnl Trantfom Tibll tlSTT] 

Uhtn i proem references any user SL ttgnemt, these stjntntt art mimi 
logical segnent nunbert if the ntu napping ucode it running. The lsij 
•nvidH I nap napping these logical segntMt into their physical tegntnt 
minbers and having true STT't for tht ntpptd segnents. Tht LSTT 1! crtited by 
LOADER during tht load tint. It occupiM an fjST and tht DST nunOer is stored 
in PCB(15). If no user SL Kgntnt is rtftrtnctd, tht LSTT uiU not be needed, 
hence it uiil not bt created. 

Tht ntu napping nierocodt depend! on the t«istence of the LSH for jetting 
the physical sequent nunbtr for a napped segnent. So the LSTT hat to bt in- 
cluded in proctts' locality list if thtrt is an LSTT. Dispatcher uill then 
bring the LSTT in before the process can bt run. Alto the bank and address 
for the LSTT belonging to the current running process art stortd in sysglob 
ctlli ( J221 and I2Z2 ) during tht launch tine by the dispatcher. These ceils 
art used by nicrocode for fast accessing the LSTT. 
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Logical Stontnt Trantforn Table f LSTT 1 (Cont.l 



• of Logical Segments 



Length of LSTT 



Physical Segnent 0 
Pointer to STT list 



Physical Segnent I 



Pointtr to STT list 











Physical Segnent » 1 






Pointer to STT lilt 1 




mi 


STT » 


1 SEC* 1 




mi 


STT • 


1 SEC i 1 












mi 


STT • 


I SE6# 1 


— > I 


Total STT't for this teg 1 








ln| 


STT a 


I SEG « 1 


l«l 


STT I 


I SEG H 1 








i mi 


STT • 


I SEG « 1 




Total STT's for this seg 1 



Logical teg 1 
Logical teg 2 



Logical seg n 
(nan 255) 



STT't for logical 
segnent 1 
(if ntedtd) 



STT't for logical 
segnent n 
(if reeded) 



G.OO.OO 

11- 15 



Private Volumes/Serial Disc 
CHAPTER 12 PRIVET E V0UJHES / SEBIRL DISC 
Haunted Volune Table tnVT SB) CCT =53 B65) 



111111 
0!1:2:3|4:S:6l?:S:9iO:1:2|3:4:5 



entry size 


: nax entries 


S of nounted 




volune sets 


loev 




: DIRBRSE 




Of SYST£!1 


- 

volune set 


0 


- 

0 





1 1 

! 

I 2 Master volune of 
I SVS VS is alusys 
I 3 ldev = 1 . 
I 

I 4 



18! 

I- 
19I 



20! 



1 22 
-I 

1 23 
-! 

1 24 



-- entry C 
(nVTRBK = 0) 
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MVTBB ICont.) 



011 Icycl I Dircsue/32 
hvoi | nvoi I ucnt 
ldev I DIRBRSE 

of volune set 
generation nunber 



ldev 
dbns 



VTRSK 
vent 



ldev : 

///////////////: 



VTB8X 
vent 



2 naster volune 
of volune set 

3 is on this ldev 



j- vol entry 0 
6 I (double) 



23 I 

|- vol entry 7 

24 | (double) 



- entry 1 
(nVTRBX = 1) 



- entry n-1 
(HVTRBX « n-1) 





D.OO.OC 
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12- 1 
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nVTRE Cent.) 






Private Volune User Table (PVUSER) DST =54 (66 ) 
111111 



Oil icyci ! Dinrsi2e/32 



1 1 hvoi i nvoi i 

i — — 


ucnt 


1 1 
— 1 


21 ldev : 


DIRBRSE 


i 2 


3j of volune 


set 


1 

i 3 


1 

4| generation 


nunber 


1 4 
-1 — - 


61 ldev : 


VTRBK 


1 5 1 
-1 1- 


I 

61 dbns : 


vent 


! 6 1 


1 1 
I i 


191 ldev : 


VTRBX 


1 

--! I- 


1 

201///////////////: 


vent 


124 1 



vol entry 0 |— entry r, 
(.double) i (nVTRBX = 



vcl entry 7 i 
(doable) i 
1 

cyclical vclime index 
(local VTSBX) for disc 
space allocation 

- highest (ordinal) volune 
index (volutie index being the 
volune set's local VTflBX) of a 
Mounted nenber of the volune 
set(class), 



nvol - a of volunes nounted for the 
volune set [class). 



ucnt - it of users having nojntec 
the volune set. 



■ directory bit nap size 
(sectors), 



- # of users having ncurteo 
the volune. 



0|1:2:3|4:5:6t7:8:9|0:1:2,3:4:5 



table size (words) 
tt of entries 
bittiask of HVTflBX's represented 
naxinun table size ( nords ) 
available pointer 
op tiask : WTfiBX 
nax users 
* pins 



I OP 



current size of entry 
PV flags 

vnask 
pin 

user bmd count 
user nount count 
systen bind count 
systen nount count 
bind nanes count 
DST tt of bind nanes segnerit 
vnask 
pin 

user bind count 
user nount count 
systen bind count 
systen nount count 



entry head 
(5 words) 



- user entry 1 



user entry 2 



- table head 
(5 words) 



-- volune set 
entry 1 
(HVTABX = j) 



C.OC.OC 
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PVUSER (Cont.) 



I- 



bind names count 



i DST H of bind nanes segnent 







vnask 






pin 




user bind count 


1 




user nount count 


1 
| 
j 


- " 

systeti bind count 


j- user entry n 




systen nount count 






bind nanes count 






DST tt of bind nanes segment 




1 
1 


op mask : nVTRBX | I 
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Bind Ranes Data Segnent (Cont.) 



GROUP 

n n n e 



RECOUNT 

m n n e 



— volume set 
entry n 
(WTRBX = k) 



Private Volumes/Serial Disc 



Private Voiunes/Serial Disc 



Bind Hanes Data Segnent 
(Created and managed via PVUSER Table) 



111111 
0|1:2:3|4:5:6|7:8:9|0:1:2|3:4:5 



0| nax segnent length j 0 

I — - I 
1 1 current segnent length j 1 



no 



bind count 


I 0 


GROUP 


— -I I 
1 1 i 




I z 


N fl n E 


-! I 




I 3 | 




-I I 

I 4 I 




1 I 

I s I 


ACCOUNT 


-I I 




I 6 | 


hue 


-I I 




I 7 I 




-I I 
HO | 



• entry 0 



-- entry 1 
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Serial Disc Tables and Data Structures 

Data Record Foraat 



The primary purpose of the Serial Disc Interface (SDISC) is to adapt the 
undefined length transfers characteristic of Magnetic tape to the fixed- 
length environment of a disc or integrated cartridge tape(ICT). To ac- 
complish this, data is buffered within SDISC. The buffer is an integral nun- 
ber of sectors (blocks for the ICT) long, files aluays start on a sector 
boundary, but data records uithin files nay start anyuhere and straddle sec- 
tor boundaries. R record in the buffer is structured as foilous: 



I record | 
I length j 
I (bytes) I 



I record I 
I length | 
I (bytes) | 



The record length is aluays a one-uord positive byte count uhich includes 
only the data portion of the record, not the length uords themselves. Records 
uithin a file night be stored on the disc as foilous: 



I RL I///////////////////////////I 

uTiniifim rl i il'\7/7mim 



I lllllllllllllllllll I RL I RL |//| 

RL I RL uiiiiiiiiinuiim 

Ullllllllln RL I RL 

I ////////////////////// 1 RL MM 

uiiiNitiiiiiiiiiiTmiTiTmun 

RL | RL | " "T 



Sector N 
I 
I 



The reason for the trailing byte count is to inpletient an easy uay to 
nac'-space records. 
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End of File Fornat 



Since files aluays start on a sector boundary, it follows that they also 
end on one. End of files consist of a 0 record length and O-fill to the end 
the current sector as follows: 



I//////////////////////// RL RL /| 
I //////////////////////////////// I 

i //////// rl rl uimmiumit i 



I /////////////// I RL I 0 



In addition, an End-of-File entry is nade in the Gap Table, so that files nay 
be skipped by scanning Gap Table entries instead of serially scanning the 
data area. The Gap Table is described a feu pages fron nou. 
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Contiguous Block Fomat 



ft serial disc, if it can do everything a Magnetic tape can do, Must also be 
a cold-load device. This neans that Machine Microcode Must be able to read a 
bootstrap channel progran and the resident segnents of INITIAL fron the disc 
into Menory.. The Microcode and channel prograns cannot deal with the record 
length words which surround standard data records, so for then we have a 
structure, called a CONTIGUOUS BLOCK, which has the data without the length 
words. Infoniation as to the length of each contiguous block mist therefore 
be kept elsewhere, so there are Gap Tabie entries which hoid the beginning 
and ending sector addresses of each contiguous block. This inplies that each 
block nust begin and end on a sector boundary. In this way they are sinilar 
to data files. To set contiguous blocks off fron nomal data, and to reach a 
sector boundary, a record length and fill character = X177777 is used, as 
follows: 



I/////// Previous records //////! 
I /////////////////////////////// I 



I //////// I RL | -1 



Contiguous block 



Sector N*1 
I 



Hole Fomat 



Holes on the serial disc have the sane fornat as contiguous blocks (that 
is, they start and end on sector boundaries uith -1 Fill characters as 
required). Starting with OPE version G.00.00, holes are obsolete and SDISC 
will not generate then. However, code has been left in SDISC to process any 
holes found on serial discs written with earlier versions of SDISC. Further 
details May be found in the Serial Disc IDS. 
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Gap Table Fomat 



The Gap Table is a four-word header followed by a series of two-word device 
address entries. R pernanent copy lives on the device, starting in sector 4, 
while a working copy lives in nain nencry. The copy in nenory is posted to 
the disc only when a backspace or rewind operation occurs after writing (in 
other words, when the copy in nain nenory has changed). The length of the 
Gap Table is device-dependent according to the table below: 

Device Nunber of sectors (or ICT blocks) 

HP7920 44 
HP7925 106 
HP7933/35 219 
HP7902/9895 26 

ICT 4 blocks ("S" cartridge) or 

15 blocks ("L" cartridge) 

The Gap Table looks like this: 

+ + 

0 | sector addr of load point |\ 

1 I unused I \ 

2 | unused I /-Gap Table header 

3 | unused I/ 
+ + + 

4 [ type | | 

+ * Sector address | Entry (two words) 

5 I I 
+ + + 

6 I type I I 

+ + Sector address | Entry (two words) 

7 I I 
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Beginning of Hole. The starting address of a "defective" area of the 
disc. Usually on a track boundary, but Hay be in Mid-track if a con- 
tiguous block was being written when the "defect" was encountered. 
Obsolete, starting uith HPE version G.00.00. 

End of Hole. The corresponding ending address of the "defective" area. 
Always at a track boundary. Obsolete, starting with MPE version G.00.00. 
Beginning of (contiguous) Block. The starting address of a contiguous 
block, exclusive of the -1 fill characters which May have been required 
to get us to a sector boundary. Unlike the End of File fill characters, 
there need not be any -1 characters if the previous record or contiguous 
block (uith or without the trailing length word) ended exactly on a sec- 
tor boundary. 

End of (contiguous) Block. The address of the last sector containing 
contiguous block data. The sector nay also contain -1 fill characters to 
get us to a sector boundary, but as with the beginning of block they are 
not required if the contiguous block ends exactly on a sector boundary. 
End of Tape nark. The sector address of the sinulated End of Tape 
reflector. This type is nou written only to floppy discs for use by 
INITIAL'S serial disc interface, linen read by IIPE's SDISC, it will be 
skipped no natter what device it is found on. This ensures conpatibility 
uith older serial discs. 

End of Gap Table. Ho associated sector address. If you hit this uhile 
scanning the Gap Table, you've gone too far. In practice, this type is 
created whenever the Gap Table is cleared, by the sirtple device of in- 
itializing the table to -1. 



The type field is bits 0, 1 and 2 of the first word. The eight possible 
types are: 

0. End of File. The associated sector address contains one or more end of 
file fill characters (0) to fill out that sector. In the worst case (the 
previous record ended exactly at the end of the previous sector), the end 
of file sector contains all zeros. 

1. End of data. The associated sector address is the last address of valid 
data plus 1, in other words, the next available address. In practice, 
such an entry is usually preceded by an end-of-fiie entry, since the EOD 
entry is written when you stop writing, and the file systen will not let 
you backspace or rewind after writing without sending a Urite End of 
File. Hn EOD entry is also uritten at the beginning of the Gap Table 
when new (unuritten) nedia is inserted. This prevents erroneous reading 
of blank Media. 
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SPISC Extra Data Segments 



Uith insignificant exceptions, SDISC operates entirely in split-stack node, 
that is, using an extra data segnent for its working storage. Starting uith 
UPE version G.OO.OO, there are tuo additional data segnents used as no-uait 
data buffers. For the ttost part, our discussion here is restricted to the 
original data segment, nou used only for variables, the Gap Table, and data 
buffer Hjnagenent. 

The uorking storage extra data segnent (XDS) is usually acquired by the ex- 
ternal procedure ALLOCATE uhen the serial disc device is first assigned to a 
user as part of an FOPEN. The external procedure DEALLOCATE nakes the XDS go 
way as part of its processing of the final FCLOSE against the device. The 
systen prog ran PVP8DC nay also acquire and release an XDS so that the tape 
label routines in LBBSEG nay also use SDISC for their uork uhen DEVREC 
processes a device on-line interrupt. SDISC allocates the tuo data buffer 
segnents as they are needed, then deallocates then as part of the Device 
Close processing. 

In addition to the Gap Table already described, the XDS contains SDISC's 
global storage area, including the data buffer nanagenent areas 
(BUFFER'INfO), and a snail buffer (called UORKTRBLE). UORKTRBLE holds the 
contents of the Serial Disc label sector uhen SDISC reads it in as part of 
its self-configuration. It also hold the Defective Tracks Table (rtfiC fanily 
discs) or Defective Sector Table (CS80 discs) uhile reassigning suspect or 
deleted tracks. 

The three arrays in the XDS (UORKTRBLE , BUFFER'INfO and GPT (Gap Table)) 
are all dynanically configured by SDISC as vanilla indirect arrays, such as 
night have been constructed by SPL. This is done by declaring the array 
names as pointers, then inserting appropriately computed elenent-0 addresses 
in then. 



The extra data Begnent is organized as follows: 



SECTORSPERTRRK 



START ADDRESS (BOT) 



EOTSECTR (disc 
address of simu- 
lated end of tape) 



EOOSECTR (last 
sector of disc) 



WRITE RING 
FATALERRQR ' 



These twelve uords are reserved 
for use by ALLOCATE uhen the data 
segnent is created. HoMever, AL- 
LOCATE only stuffs the last five 
of then. Lie fill the first seven 
ourselves uith infornation ue get 
fron the label sector. 



Sinulates tape runoff. 



Tells us to initialize SDISC 
parameters to BOT if true. 
Simulation of tape write ring. 



I Disables SDISC uhen true. 



c-.oo.oo 
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10 I No longer used. 

11 I'nmX'DSEG'Slk" ' 



I SDISC global vari-| 
I abies, including) 
I array pointers. 




flax size of our XDS, so ue can 
check that it's big enough. 



Length is 512 uords. 



Length is calculated as 
HfiX'NUfl'BUFFERS (currently 2) * 
NFO'EMTtt'SXZE (currently 8). 



Length varies uith device, and is 
calculated by SDISC as part of its 
self-con figuration. 
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Serial Disc Organization 



The disc is organized as foilous: 



I Label sector 
# 

I DTT/DSCT 

•f 

I Cold load 

* — 

I Soft dunp 

t -• 

I Gap Table 

! '. 



Last data sector | 



I 0 See expanded view in Chapter 3. 

-+ 

I 1 DTT (HAC fanily) or DSCT (CSSO). 
-+ 

I 2 HP-IB cold load channel prog. 
-+ 

I 3 SOFTDUHP channel program. 
-+ 

| A to START ADDRESS - 1. 

I 

I 

-+ 

| STBRTfiDDRESS 

I 

I 

I to 
-I 

| EOTSECTR 
■ I 

I to 
• I 

EODSECTR 
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CHAPTER 13 I/O 
I/O Table Linkage 



->/ LOGICAL \ I/O TABLE LINKAGE 
\ DEVICE / 



— I 

I 

! I 



DITP 
FLAGS 



100* 

>| FLAGS I 
I IOOP I 

-I I LDEV | 
I I 



I DLT |<- 



->| FLAGS 

I DITP 
-| IOOP* 

I UNIT [LDEV 
--I OLTP 

I ILTP 



I ILT 



I I I 

I I 

I I ! 

I I 



jChl I DAT | 
SIOP | 
ONIT EXTRACT 



I I 
I I I 



I 



ISIOP 10*1 
I SHE I I 



I 



I I I DITP |< 

! I I I 

I I 

I I 

I I I- 



* ORQ for disc requests 



>|SI0 PROG AREA 
I DRT I 
I SIOP | 
I PI ! 
->| ILTP | 
I I 
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Device Reference Table (DRT) 



HP-IB Systens 

8 | Bank of DRT I 
I— 1 

9 I Offset of DRT in Bank I 



DRT ENTRY ON /33, /44 
SIOP 
DBI 

PI 

Channel Flags 



> 1 



< 1 



SIOP - absolute address of SIO progran 

PI - interrupt handler plabel 

DBI - this is the absolute address of the ILT 
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Driver Linkage Table (OLT) 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

|..|..1..|..|..|..|..|..|..|..|„1-|-|-|..|..| 

I |DF |f1C ICR I 10 ItlTYP | 

0| OUEUE NUMBER I (SEE BE LOU) I DPROC 

I - 1 

1 1 MONITOR PLABEL I DHNTR 

I I 

2 | INITIATOR PLABEL I OINIT 

| 1 

3 1 COilPLETOR PLABEL I 0OT1P 

| 1 

4 | INTERRUPT PLABEL I DINTP 

| 1 

5 1 DIT SIZE I OEVICf TYPE I DTYPE 
| 1 

61 CS DRIVER EDITOR PLABEL I 
| 1 

7| INITIALIZATION PLABEL I 
| 1 

There is one DLT for each type of driver. A pointer in the DIT alloMS 
different devices on a controller to have different drivers and 
interrupt handlers. 

DPROC. QNUH6 - This field contains the I/O process request queue 

nunber for type 2 drivers. Zero for all other types. 
.(8:1).DRVRFRZN - Driver code frozen. Set by flAtl when then the driver 
(DF) code segnent has been nade present and frozen fron a 
request fron SIODn. 
.(9:1).t1AHERR0RC- HAI1 Error on Code hakepresent 
(110 

.(1O:1).C0RERES - If set both initiator and conpletor code are cere 

(CR) resident. 
.(14:2).DRVRTYPE- DRIVER/H0HIT0R TYPE 

(I1TVP) 0 - not used 

1 - driver can be executed on any stack 

2 - driver can be executed in the user process or 

in the I/O process identified by IDNUfffl 

3 - run only in process whose PCB nunber is in 

IOHUnB 

DflNTR - I/O rlonitor Plabel. 

DINIT - Driver Initiator Procedure Plabel. 



Loqical-To-Physical Device Table (LPDT) 



DST ■■ 
SIR • 



13 (= 
9 (= 



Z15) 
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The LPDT has several fields uhich describe the state of a device. Sone of 
these fields have the sane neaning for all devices. Others are device depen- 
dent. All are described belou. 

There are tuo types of devices represented in the LPDT: real devices and vir- 
tual devices. A real device is one uhich has been configured into the systen 
and is capable of perfoming input and/or output. A virtual device sinulates 
sone of the properties of a real device (for exanple a spooled line printer 
or an INP), but there is no physical I/O involved. The two nain uses for vir- 
tual devices are for OPEN spooled devicefiles and certain connunication 
devices (such as INP's). 

A given virtual device entry is in use only Hhile the devicefile it 
represents is open. Uhen the file is FCLGSEd, the entry becones available for 
another virtual device. This is the reason for the SYSOUtlP/INITIAL con- 
figurator question HAN ft OF OPEN SP00LFILES~it needs to know how nany vir- 
tual device entries to allocate to the LPDT (and to the LOT). 
Entries in the LPDT are ordered by logical device nunber. The first HOrd ad- 
dress of a real device entry is obtained by nultiplying the LDN by the entry 
size. Except for the Oth entry, entries for which no logical device is con- 
figured on a given systen are used for virtual device entries. Any renaining 
virtual device entries follou the last real device entry. 



DCOdP - Driver Conpletor Procedure Plabel. 

DINTP - Special interrupt handler Plabel. This procedure is called 
by GIP if ISPEC is set OFLAG. No other action is taken by 
GIP except to set the Interrupt Status in DSTAT. 

DTYPE. OITSIZE - The length of the DIT in uords for this driver. 
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Entry 0 


Typical Entry (Rll Real Devices) 


0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

4 --|--|--l-l--l--l--!--l--l--l"l--l"l"i--f--+ 
0| Nunber of entries in table | 

+ + 

1 1 Entry size = 4 | 

+ _ _ --- + 

2 1 DEVREC service request count | 
3 1/////////////////////////////////////////////// 1 


0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 IS 
♦-|"|-|"|-|--|-|--i--|--|--|--|--|-|--|--+ 
01 0|////////////////////////////////////////////| 

IDevc | J|Da| | D| I| End of I I |Ru: Device I 
HOwnedl o|ta| I u| n| File j j | to: Subtypel 
IStatel b| | | p! tlCnditionj 1 1 : 1 

21 SYSDB-relative pointer to the DIT | 

3 1 /////////////////////////////////////////////// | 


Discussion: 

Uord 2 is incretiented by a device driver whenever it sets the Device 
Ownership State field (beiou) to 2 (Service Requested). DEVREC decrenents the 
count for each interrupt it services until the count reaches 0, at which tine 
DEVREC hibernates. 

-- CAUTION -- 
Device drivers tiust loch this table by DIS- 
ABLE/ENABLfing, -NOT- by trying to acquire 
the LPOT SIR. 

Tvoical Entry (Virtual Devices) 

0 1 2 3 4 5 fi 7 8 9 10 11 12 13 14 15 
0| 1j Pointer to XDD subentry | 
11 11:111 ill I 

3 UO I //////////////////////////////////////////// 1 
10 — 0 for input, 1 for output. 

Uord 0, bit 0 is 1 for a virtual device, 0 for a real device. The fields in 
uord 1 are the sane, as applicable, as for the real device represented by a 
given virtual device. See below. 


Discussion: 
Uord 1.( 0:2) — Device Ownership State: 

0 — Mot ouned by any process. 

1 — Owned by a process. 

2 — Service requested. Set by driver for 

unexpected interrupt, then wakes DEV- 
REC. 

3 — Service granted. Set by DEVREC. Logon 

sequence is 0-2-3-1 . 
3 -■ Device reserved (alternate use). Set 

during STRRTSPQOL, spooler process 

sets to 1 when it gets started. 
Uord 1.E 2:1) -- Device is Job/Session Accepting if true. 
Uord 1.{ 3:1) — Device is Data Accepting if true. 

Uord 1.£ 5:1) — Device is Duplicative if true (all devices except discs). 
Uord 1.( 6:1) — Device is Interactive if true (all devices except discs). 
Uord 1.( 7:3) — End of File condition: 

0 — No EOF detected. 

1 — Hardware EOF (e.g., tape nark). 

2 — :DATR record read. 

3 — :£0D record read. 

4 - : HELLO record read. 

5 ~ :8YE record read. 

6 — :J08 record read. 

7 :E0J record read. 

Uord 1.(12:4) — Device subtype. See discussion for tape entry (below) for 
a description of the Auto bit (12:1). 
The retaining bits in Uord 1 are device-dependent and are described with 
their corresponding entry diagram. 
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Entry for Terninal-Like Devices 

0 1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 
+HH--I--I--I--I--MH--I--I-I--I--I--I--+ 
Ol 0I////////////////////////////////////////////I 

IDevc | J|Da|Ct| Oj Ij End of | B| L| Device I 
1|0uned| oltallYj u| n| File | rf o| Subtypel 
IStatet b| | | p| t|Cndition| M g| | 


Uord 1.(12:1) — Part of Device Subtype field. If true, device is allocated 
autonatically when opened. If false, operator nust 
allocate. 


Entry for Disc Drives 

0 1 2 3 4 5 fi 7 S 9 10 11 12 13 14 15 


2| SYSDB-relative pointer to the DIT | 


+-|--|-|--|--(-|-|-|--|--|--i"!--|-!--|--* 
0 I 0 | //////////////////////////////////////////// I 


a!///////////////////////////////////////////////! 

Discussion (unique fields only): 
Uord 1.( 4:1) - CONTROL-Y is alloued and has been detected. 


IDevc | J|Da| N|Ht|RV| End of | S| F| Device | 
1|0wned| o|ta| S|d I I File |or| o| Subtypel 
IStatel b| | D|PV| |Cndition| F| r| | 

2| SYSDB-relative pointer to the DIT | 


Uord 1.(10:1) - BREAK has been detected -OR- ignore BREAK if the C.I. is 
running. 


3 1 // 1 SO | ///////////////////////////////////////// 1 


Uord 1.(11:1) — The teminal is logging on. This bit is set by PROGEN and 
DEVREC uhen the logon sequence starts. If the bit is off 
when polled by INITJSttP, the teminal has disconnected. 
For new, only lOTERHO and HIQTERH support the use of this 
bit. Multipoint and DS pseudo-terninals do not. 


Discussion (unique fields only): 
Uord 1.( 0:2) — Device Ownership State. Hay not be 1 (ouned) for shared 
device (systen volune or private volune). Serial and for- 
eign discs are non-sharable and nay be owned. See the full 
discussion of this field under Typical Entry, above. 


Entry for Taoe Drives 


Uord 1.( 4:1) — If true, the disc is a nonsysten donain (private volune, 
serial disc or foreign disc) disc drive. 


0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
+ --|„t„|„|..|.-|._|„|..|__|__ [ __|__|„|..|_„ + 


Uord 1.( 5:1) — If true, disc is a nounted private volune. 


0| 01////////////////////////////////////////////I 

IDevc | J|Da| B| D| I| End of | | fl|flu: Device I 
1 lOunedj ojtal D| u| n| File j I Vjto: Subtype) 
IStatel b| | T| p| tiCnditionl | R| : | 


Uord 1.( 6:1) — If true, the disc is a reserved voluwe used to satisfy the 
requirenents of a Multiple volune private volune set. 

Uord 1.(10:1) — If true, the disc is a physically and logically Mounted 
serial or foreign disc. Bits 5 and 6 nust be false. 


2| SYSDB-relative pointer to the DIT | 


Word 1.(11:1) If bit 10 is true, then 1 ==> foreign disc, 0 ==> serial 
disc. 

Uord 3.( 1:1) — If true, the device is currently being used as a serial 
disc (that is, it is allocated to a user as a serial 
disc). This bit duplicates a bit in the LDTK entry so that 
this infornation can be found in a systen (nenory- 
resident) table. 


3 1 /////////////// / ////////// ///////////// HII llll [ 

Discussion (unique fields only): 

Uord 1.( 4:1) — BOT. Tape is at Load Point -OR- no tape nounted. Recording 
density nay only be switched uhen this bit is true (for 
Multiple density tape drives). 


Usrd 1,(11:1} — If true, DEVREC is perforning Rutonatic Volune Recognition 
(RVR) on a tape (or PVPRGC is doing the sane on a serial 
disc), -OR- RVR is to be suppressed on jab or data accept- 
ing devices. 
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Logical Device Table (LPT) 



Overview of Data Seqrtenl 



DST 14 (= X16) 
SIR 10 (= 112) 



Logical Device Table 
(LDT) 






Logical Device Table 




Extension 




(LDTX) 







Typical Entry Fomat 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

+H--I--I--I--I--I--I--I--I--I--I--I--I--IH--+ 
i File use count |0 
t + 

I Volune table index if device type = 0-7, else I 
I nain process pin ft or spooler process pin ft |1 

+ ---+--+--+ + 

I Record Hidth |CS|F0| Device type |2 
+ +_-+—+—+-. -+--+--.+—+-_+__ _ 4 

I Spool | Sy | Di | Dn | T r | Hd t CI | S | Device-dependent | 
|state|st|aglRq|lr|r I as I Q| info (see belou) |3 



Milium 



HDD head index 
CONTROL- Y pin 



Logical Device Table 

Zero Entry Fomat 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
+ --|--|--| H _-|__|__|„|__ MH __ MH __|__ + 

0| Highest entry nunber | 
t + 

1 1 Entry size = 7 | 
+ + 

2| Streans device nunber | 
+ + 

SI///////////////////////////////////////////////! 

Miiiifiiiifiniiiiiiiuiiiiiiiiuiniiiuiuiiin 

S\ltlllll!!ffnfit!lli!fllilll!llllll!tfillUiUI\ 

6 i /////////////////////////////////////////////// I 

7I///////////////////////////////////////////////I 
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Uord 


2 


(S 


1) -- 


Uord 


2 


(9 


1) -- 


Uord 


3 


(0 


2) -- 


Uord 


3 


(2 


1) - 


Uord 


3 


(3 


1) -- 
1) -- 


Uord 


3 


(4 


Uord 


3 


(5 


1) -- 


Uord 


3 


(6 


1) - 



I Default output device -OR- default class index | 6 
I (see discussion) | 



If set, there are special forns nounted on the device. 
Spooled state of the device: 

0 — Not spooled. 

1 ~ Owned by an input spooler. 

2 -- Ouned by an output spooler. 

Device is available to systen (not doun). 

Device is available to diagnostics (obs). 

:D0UN requested, honored when use count - 0. 

If set, trailers are disabled. 

If set, headers are disabled. These two bits are 

nanaged such that header/trailers are generated in 

pairs or not at all. 

If I/O, uord 6 is the Device Class Table 
index/LDEAffl of the default output class/device 
associated with this device. 
Spooling has been enabled (spool queues are 
open) for this device. 
Device dependent inforrtation: 
1. For teminal-like devices, the default 
terninal type to be used if not speci- 
fied in the : HELLO cofinand. 
For variable density tape drives: 
- actual tape density. 
■ density requested in FOPEH for writes to 
unlabelled tapes only. 
For either: 

0 = unknown density/no FOPEH u/ urite. 

1 = 1600 BPI 

2 = 6250 BPI 

3 = 800 BPI 



G.00.00 
13- 10 



Uord 3.(7:1) 

Uord 3.(8:1) ■ 
Uord 3.(9:7) 



Uord 3.(10:3) 
Uord 3.(13:3) 
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Logical Device Table Extension (LDTX) 
Overview of Data Segrient 

+< DST X16 



DST 14 (= 216} t- 
SIR 10 (= Z12) 



Logical Device Table 
(LDT) 



Logical Device Table 
Extension 
(LDTX) 



I / 0 

Zero Entry 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
+HH--I--IH--I--M--I--M--M--I--I--+ 

0 j Highest entry nunber \ 
+ + 

1 I Entry size = 5 I 

2 \ll!lllll!lllllltllllllllllllll!lTl)miTlTlTlTl\ 

3 I llHllllllllllllllllllllllllitlllillllillllllll I 

4 \ll HUM III III II II I HI 1 1 Mil I II I Willi Hill l\ 

4 + 

Typical entry 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
0 | S | SO I CP I FS I OS I Reserved I Device-specific I 



1 I 

+ - 

2 I 



4 I 



infortiation 
fields. 
See the following esar? 
of LDTX entries. 



S... 
SD. . 
CP. . 
FS. 
DS., 



..Seek ahead enable/disable flag (systen or PV disc only). 

..This logical device is a Serial Disc or a Foreign Disc. 

..This logical device uses the CIPER protocol. 

..This is a systen or PV disc uith Disc Free Space nanagenent. 

..This LDEV is a DS or data connunications device. 
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Terninal Entrv 




Serial or Foreiqn Disc Entry 


0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

■• — 1 — t — f — t — • — 1 — 1 — 1 — I — ■ — 1 — 1 — 1 — • — • — * 




0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 


0 1 01 01 0| 01 01 Reserved I T8RC I 




+HHHH--l--l--iH--l--IH--l--l--l--l--+ 
O I 0| 1| 0| 0| 0| Reserved 


1 I Terninal Descriptor Table Offset I 

2 wuiiiiiiiiiiiiiiiiiiiiiimiiiiiiimiiimin 

3 \iiiiiiiiiiiiiiiitiiiiiiiimiiiiitiiiiiiiimii\ 




1 | SDISC: XDStt for variables, Gap Table I 
1 FDISC: 1 | 
♦ + 

2 | S01SC: 1 ==> data buffer XDS's acquired | 
I FDISC: not used. j 


4 \iiiiiiiimiiiiimiiiiiimiii!ii!iiiiiiiiiiii\ 




3 | SDISC: PCB index uhen UAITing, else 0 j 
I FDISC: not used. j 


TBRC. Terminal's baud rate code (CPS = characters per second). 






Speed (CPS) BDCC/BTP (HPIB) TBRC 




+ + 

CIPER Entry 


Hot known 0 
1920 16 (P.TP only) 
960 8 
480 9 
240 7 
120 11 

60 i 

30 13 

15 14 

14 




0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

0 | 0| 0| 1) 01 01 Reserved | DB | ///////////////// | 

1 | CIPER Device Control Data Segnent 8 (CDCDS) | 

2 |DN| CTn Index for this device (CTfll) i 

3 1 iiiiifiiiiiiiiiinmnfiiiiuuiiNHiuiiun 1 


10 15 






US This terninal is connected to a Workstation Configurator port. 

TDT offset.. .Offset frtMi the base of the Terninal Descriptor 
Table (TDT) to the TDT entry for this terninal. P. 
-1 indicates no TDT entry exists for this terni- 
nal. 




DB If set to 1, then debugging is in effect. 

ON If 1, the CIPER facility has been de-activated for this 

device because of error. 
CTfll. ..Control Table (lap Index (an index into the Control 

Table Dap (CTH) t uhich is located in the CDCDS. 

Svsten or Private Volune Disc Entry 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
+H ..| HHHH -_| H __|__[__,__|__ MH _. + 

0 | SI 0| 0| 1| 01 Reserved 1 ///////////////// | 

1 I/////////////////////////////////////////////// I 

2 I Disc Free Space DST nunber (DFSDST) | 

3 | Disc Free Space error status (DFSERR) I 

+ + 

S Seek ahead enable/disable flag. 
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Device Class Table (DCT) 




Typical Entry Fomat 


Overview of Data Seqnent 




0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 


DST 40 (= WO) ♦ ♦< DST Z50 

SIR 40 (- 250) | | 
Device Class Table } 
I I 
I (DCT) | 
I I 




01 1 
1 1 
11 

I Class nane (ASCII) | 
21 \ 


+ + 

I I 
I Terninal Descriptor Table I 




i 1 
31 1 

4|//| Cyclical pointer |SQ| T|Class Access Type| 


! (TDT) ; 
I I 




+--+ 4—+—* 1 

5[ Nunber of devices in class (N) | 


+ + 




61 LDEV #1 | 


Device Class Table 




7| LDEV #2 | 
+ + 


Header Entry Fomat 






0 1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 
♦„|..|-|„|„|..|„|„|„|„|_.|„|„|„|„|„ + 

0| Total table (segnent) size | 




N+5I LDEV ft N ! 


1| Entry size (variable, this uord set to 1) [ 




Discussion: 


+ + 

2 1 Nunber of device class entries I 

3| Pointer to first device class entry | 
(segnent relative) | 

4| Nunber of terninal descriptor entries | 

5| Pointer to first terninal descriptor entry | 
1 (segnent relative) ' j 




The Device Class Table (DCT) contains a varying nunber of variable length 
entries. This is because you nay configure an arbitrary nunber of device 
classes on a systen, and each device class nay be conprised of an arbitrary 
nunber of logical devices. There is one DCT entry per device class, and each 
DCT entry contains a list of logical devices in the class. There is no es- 
tablished order of entries in the DCT, nor is there an order of LDEVs within 
an entry. 

Due to the haphazard nature of the DCT, its overall properties are kept in 
the header entry. These include the segnent-relative starting address of the 
DCT (in case the header entry should be expanded later) and the nunber of 
entries in the table A segnent -relative pointer to the Tertiinal Descriptor 
Table (uhich follows the DCT) nay also be used to calculate the size of the 
DCT. Also note the "Entry size" word. It is neaningless for this table, but 
is included for conpatibility with other fixed-length entry I1PE tables. 
Since the DCT entries are of variable length, uhen you uant a particular 
entry you Must aluays start at the beginning of the DCT and link through each 
entry until you find the one you're interested in. 

8 few of the fields in the DCT require further description: 

Uord 4. ( 1:7) Cyclical pointer. Currently used only for system and 
private volune disc devices. The pointer varies frow 1 to N (nunber of en- 
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tries in the class) and indicates the LDEVft in the class list on which the 


Interrupt linkaqe Table (ILT) for HP-IB Systens 




last extent was allocated. The disc space allocation routines uill try to 








satisfy the next re* - quest on the next disc drive indicated by the cycli— 








cal pointer (uith wraparound to 1 if the pointer > N). If that fails, 


0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 






the pointer is incremented until space is found or all devices in the 


+ — t— +—+—+—+" +—+— + — 4— +--+ —+— +—+—+-- + 






class have been tried. 


0 | Channel I 


ICPVAO 






1 Progran ! 


ICPVA01 




Uord 4.( 8=1) — If set, spooling has been enabled (spool queues opened) 


2 j Variable I 


ICPVR02 




for this device class. 


3 I Area (ICPVfl) | 


ICPVA03 




Uord 4.( 9:1) — If set, the class is a terninal type class. 


4 j DI1R Abort j 


ICPVH04 




5 j Address I 


ICPVA05 




Uord 4.(10:6) — Usually the sane as the device type represented sented by 




ISRUL/ICPH1 




the class (0 f or24 for tape , 32 for printer, etc .). Serial disc classes 


6 1 0 I 




are disc devices accessed as tape drives, so their true device types are 








kept in the LDT, uhile this field holds a special cial type (31, or 137), in- 


7 | H| CHHNQUE | | CHAN | OEV | 


ICNTRL 




dicating a serial I/O (non-concurrent) device. Similarly, a foreign disc is 




ISIDP 




a nonsharable disc drive, so that fact is reflected by a special type 7 in 


210 ISVSD8 relative pointer to channel program area. | 




this field, even though the true hard- ware type is kept in the LDT, as for 








serial discs. 


211 | SYSDS relative pointer to status return area, j 


ISTAP 






+ + 

Z12 jsingle instruction that is executed to extract I 


IUNIT 






jthe device unit nunber from the status pointed I 








jto by ISTAP. j 








213 ISYSDB relative DIT pointer of the device I 


ICDP 






j currently using the channel to perform a data j 








I operation. I 








214 j SIOPSIZE j CQUEN | 


XQUEUE 






215 |RUiUP|IG|SC|SQ| I HCUNIT | 


IFLRG 






+ + 

216 | SYSDB relative DIT pointer for unit 0 I 
+ + 


IDITPO 






+ + 

ISYSDB relative DIT pointer for unit n | 


IDITPH 






I Progran status return area ! 








j pointed to by ISTAP I 
+• * 








I Seekiiask (Disc only) | 








+ + 

I I/O I 








Program | 








I Area I 
+ + 






G.00.00 


G.00.00 






13- 17 


13- 18 






I / o 


I / o 






ILT (Cont.) 


Device Information Table f DIT 1 






IPCVfl - These four words comprise the channel program 








variable area uhere information is stored concerning 








a channel progran Interrupt instruction or abort. 


There is one DIT per physical device. If a physical device 


represents 


CPVHO should be used only for channel progran aborts. 


represents more than one logical device, the logical device nunber is ob- 


ICPVfW - Words 4 and 5 contain DHA address, when channel progran 


tained from the I/D queue element. Although details of DIT's 


vary uith 


aborts during DHfl transfer. 


device, the following structure is common to all: 






ISRQL - Serial poll request queue length. HP-IB Systens do 








not support any serial poll devices. This should 


DIT for HP-IB Systems 






aluays be zero. 








ICPGH - This is the SVSDB relative address of the channel progran 








to be started for this device after receiving a HIOP 








interrupt in GIP. GIP will call STHRTIO uhen the flags 








word indicates "ignore halt interrupt" and "start channel 


0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 






progran" bits are set. 








ICNTRL - Contains controller information. 


0 IT |D |AC|RQ|SI|nUi 0| I0| IH| HOIST | MS | STATE | 


DFLflG 




.H If set, the controller is sharing a software channel 








resource in order to Unit bandwidth. 


1 ISYSDB relative pointer to the DIT for the next | 


DUNK 




.CHHO The software channel resource nunber. 


j device requesting this resource or service j 






.DRTN The DRT nunber for a Series 33 device is equivalent to: 








.CHUN - channel nunber (4 tiost significant bits of DRTN) 


2 ISYSDB relative pointer to the first IQfl in | 


DIOQP 




.OEV - device number (3 least significant bits of DRTN) 


| request list for this device j 






IFLflG - Used for controller flags. 


+ + 


DLDEV 




.RU Runuait flag, fin idle channel progran should be started 


3 1 Logical device nunber | 




when there are no active requests to process. 


+ + 


DDLTP 




.UP Uaitprog flag. Rn idle channel progran has been started 


4 ISYSDB relative pointer to Device Linkage Table I 




for this controller. This bit is reset by an interrupt. 








.IG Ignorehi flag. Rn HIOP instruction has been issued against 


5 ISYSDB relative pntr to Interrupt Linkage Table | 


DILTP 




this controller, but the channel progran was not in a 








wait statertent. Therefore, ignore the interrupt generated 


6 | Controller Hardware Status I 


DSTPT 




by the channel code uhen this progran halts. 








. SC Start channel progran flag. Uhen set along uith the IG 


7 lHarduare error status. Set when the driver | 


DSERR 




flag, GIP will start a previously attempted SIOP on this 


| detects an error. Uhenever <X), the driver j 






device. 


j monitor logs an I/O error and clears this uordj 






.SQ Start channel progran "queued" flag. Uhen bit SC is set, 




(DTIfiE) 




this bit uill determine if the call to 5THRT' HPIB will 


8 I Device Dependent Area 1 




have logical parameter QUEUED true or false. 




(DTRQK) 




.HCUNIT Highest configured unit nunber for this controller. 


9 | Device Dependent Area I 






10| IOT I/////////////////I Phys. unit « I 


DUNIT 





DTRQX Used by sone device drivers, it denotes tirter 
request index. 
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PIT Teminoloqv for HP-IB Systens 



OFLAG - DEVICE RELATIVE FLAGS 
T SET IF DEVICE IS fl TERTIINRL. 
0 SET IF DEVICE IS fl DISC. 

AC ACTIVE BIT. 1 II1PLIES A nONITOR CURRENTLY SERVICING 
THIS OEVICE. 

REQUEST BIT. 1 IhPLIES SERVICE REQUESTED WHILE 
IKHITOR IS ACTIVE. 
IF SET, (1ULTIPLE UNIT CONTROLLER. 
IF SET, THEN R CHANNEL PROGRAF1 IS CURRENTLY EXECUTIHC. 
IF SET, AN INTERRUPT OR RESPONSE HAS OCCURRED. 
IF SET, DEVICE IS IN A NOT READY OR OPERATOR UBIT. 
IF SET, AN IDLE CHANNEL PROGRRF1 SHOULD BE STARTED FOR 
THIS DEVICE. 

SPECIAL INTERRUPT HANDLER 
DO HOT SHORT UAIT THIS DISC 
STATE CURRENT DRIVER STATE AS DEFINED BY THE MONITOR. 
ALLOWABLE STATES ARE: 



RO 

nu 

10 

IP, 

NO 

ST 



NS 



0 - START REQUEST 

1 - NOT USED (BUT RESERVED) 

2 - CALL DRIVER INITIATOR 

3 - CULL DRIVER COilPLETOR 

4 - NOT USED (BUT RESERVED) 

5 - C0I1PLETE REQUEST 

E - UNEXPECTED INTERRUPT OCCURRED 
7 - START OPERATOR INTERVENTION URIT 

110 - UAITING (ON OPERATOR). RESTART RT 0 

111 - UAITING (DATA (1RKEPRE SENT/FREEZING) 

X12 - UAITING (INITIATOR CODE flflKEPRESEHT/FREEZE J 
X13 - WAITING (FOR COHPLETION INTERRUPT) 
Z14 - WAITING (FOR DEVICE CONTROLLER AVAILABILITY) 
115 - NOT USED (BUT RESERVED) 
Z16 - UAITING (INITIATOR CODE HAKEPRESENT) 
117 - UAITING (COHPLETOR CODE HAKEPRESENT ) 
IOT - I/O Systen type O-Senes II/III I/O Systen 

1 - HP-IB Systens 

2- unused 

3- unused 



Device Information Table (PIT) for CIPER 



There is one DIT per physical device. If a physical device represents nore 
than one logical device, the logical device nunber is obtained fron the IOQ 
elenent (however, this driver only supports one device per controller.) The 
Follouing diagran shows the DIT used for the HP-IB CIPER physical driver. 
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110 - wait for interrupt (operator intervention) 

restart at state 0 
Z11 - uait for data segnent freeze, then state 2 
X12 - uait for driver initiator to be frozen, then 

allocate controller (state 2) 
Z13 - wait for I/O conpletion interrupt, then state 3 
Z14 - uait for controller, then call driver initiator 

21 5 - not used 

216 - uait for initiator nake present, then state 2 
Z17 - uait for conpletor nake present, then state 3 

OLDEV - I/O systen type, unit and logical device nunber 

0 - HP30OO Series ill/Ill 

1 - HP 3000 HP-IB 

2 - Unused 

3 - Unused 

DSAVE - Device processing flags 



VS - VALID STATUS 
OB - DVRABFLAG 
RE - RETRYFLAG 
TP - TIHERPOPPED 
NR - NOTRDYFLAG 
NR CNT 

DEVICE STATUS 
BIT 8 
" 3 
» 10 
" 11 
" 12 
" 13 
" 14 
" 15 



Set to indicate Device Status has been updated. 

- Sequence Abort in progress due to A90RT request. 

- Sequence Abort in progress due to an error. 

- Current error is due to software tiner popping. 

- Not Ready Uait in progress. 

- Nunber of Not Ready Waits during this request. 

- Device status returned during a Sequence Abort. 

CRC available and enabled. 

Reserved. 

Reserved. 

Reserved. 

Power fail or reset has occurred. 
A protocol error has been detected. 

- A parity error has been detected. 

- The peripheral has data to send. 



OSERR - Pointer to status to be logged. 

Bits(0:8) - Nunber of uords to be logged. 
8its(8:8) - Offset relative to DITP(O). 



DtOUNTS 

RF - RES FRILED 
UE - UNIT ERROR 
DE - DATA ERROR 
TO - THE OUT 
UNIT CNT 
DRTA CNT 
TO CNT 
PRTY CNT 



- Error flags and error counts (4). 

- An error has forced this request to be aborted. 

- The current error is a Unit Error. 

- The current error is a Data Error. 

- The current error is a GIC Tine Out Error. 

- Nunber of Unit Errors during this request. 

- Nunber of Data Errors during this request. 

- Nunber of GIC Tine Guts during this request. 

- Number of HP-IB Parity Errors during this request. 
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0 1 2 3 4 5 6 7 I 9 10 11 12 13 14 15 IWEfBNIC 

+—♦—+—♦"+"♦"♦—+—*"+—*—+—+ + 

Ol Ol OIACIRQI 0| 0| 0II0|IA|N0IST| 0| STATE I OF LAG 

4—4—4— 4— t— t ..t.. t — t .-t—t— t .-t 4 

1| SYSDB relative pointer to the DIT for the next I DLIHK 
I device requesting this resource or service 
+ - + 

21 IOQ table index to the first IOQ in | DIOQP 

i request list for this device 
+ + 4 4 

31 IOT i Phys. unit * I Logical device nunber I 

4 4 + + 

4j SYSDB relative pointer to Device Linkage Table I 



OLDEV 
DDLTP 
DILTP 
DSHVE 
DSERR 

DTINE 
DRQST 



5| SYSDB relative pointer to Intrp Linkage Table I 

4—4—4 — 4—4—4 4 4 

6IVS|AB|RE|TP|NR| NR CNT | DEVICE STATUS I 

4—4—4— 4— 4—4 , .4 

7| Hardware error status. Set when the driver | 
I detects an error. Whenever <>0, the driver | 
I nonitor logs an I/O error and clears this uordj 

« - - 4 

Z10| Bit 0 is set at conpletion of tiner | 

4 4 

XI 1 | Holds the tine out request entry index uhile I 
I a tiner is active. ! 

4—4—4—4—4 4 4 4 4 

Z12|RF|UE|DE|T0|UNIT CNT (DATA CNT| TO CNT IPRTY CNT| DCOUNTS 

4—4 — 4 — 4..,. 4 4 4 , 

21 3 1 Error logging location B1 | DLOGERROR 

♦ - - 4 

Z14I Error logging location #2 | OLOGCOWT 



DFLRG - Flags and request state 
AC ACTIVE - A nonitor is currently servicing this device. 
RQ REQUEST - A service request is pending while the nonitor is 
active. 

■ An I/O Channel Progran is running for this device. 

■ Rn interrupt or response has occurred for this device. 
Go to state Z10 after Idle Channel Progran is started. 
The device nonitor is starting an Idle Channel Progran 
for this device. There is no IOQ associated with this 
type of request. 

State of the device nonitor. Specifies the next action 
to be taken in SIODH in servicing the request: 

0 - start new request 

1 - not used 

Z - call driver initiator procedure 

3 - call driver conpletor procedure 

4 - not used 

5 - process request conpleted 

6 - initiate device recognition sequence 

7 - start operator intervention wait 



10 IOPROG 

Ifl IRK 

NO NOTRDY 

ST STUAIT 



STATE 
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DIT for Channel Devices 

0 1 2 3 4 5 6 

| 

0|TERt1|DISC|ACT|REQI 

I I I I I 
| 

1 



9 10 11 12 13 14 15 



I n | SIO I 10 IIAKI l\ |NT| | 
IUNITI PREHP|PROG| |HEAO|RY[ I 



LOGICAL DEVICE NUH8ER 
DLTP 



Controller Hardware Status 



Hardware Error Status 



10| IOT 1 



STATE |DF LAG 
I 

I 

IDUNK 



DIOQP 
OLDEV 
DLTP 
DILTP 
DSTAT 
DSERR 
DTIHE 
DTRQX 
DUNIT 



I 



DRIVER DEPENDENT DIT AREA 



DFLAG.TERfllNfiL - Device is a terninal 

.DISC - Device is a Disc (Bit 0 = 0) 

.ACTIVE - A nonitor is currently servicing this device 

.REQUEST - Service requested uhile nonitor was active 

. HUNIT - device controller servicing nultiple units 

.SIOPREflPT- If set then a request has been queued for 

this device. Preenpt code is set in IOQ. 
.IOPROG - I/O progran in progress. Decrenent SIOCOUNT and 

check for nulti-channel when conpiete 
.IRK - Interrupt or Response has occurred, 
.n HEAP -Moving head disc 

■NT Rpv -Not ready for SIO. SIODH holds off next SIO until 
BLLOUPOLL is done. 



DTSQx 



- Used by sons device drivers, 
request index. 
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PIT for Channel Devices fCont.) 
OFLfiG. STRTE 



DUNK 

dioop 

DLDEV. 



DDLTP 
DILTP 
DSTRT 



LDEVN 
UNIT 
IOT 



- this quantity specifies the next action to be taken 
in servicing the request. 

0- neu - start request. 

1- not used. 

2- call Driver Initiator Procedure 

3- call Driver Conpletor Procedure 

5- conplete request 

6- device recognition 

7- start operator intervention wait (210) 
Z10-restart request on interrupt 
Z11-uait for data to be frozen then state 2 
Z12-uait for driver code to be frozen then state 2 
Z1 3-call conpletor on interrupt 
Z14-uait for device controller 
115-not used 

Z16-wait for initiator Make present then state 2 
Z17-wait for conpletor nake present then state 3 

■ SVSDB relative pointer to the DIT for the next device 
requesting this resource or service. 

- SVSDB relative pointer to the first 100 in the request 
list for this device 

- Logical Device Nutiber 

- unit nunber of the physical device. 
• 10 type 0=> Series III I/O, 1=> HPIB I/O 

■ SVSDB relative pointer to the DLT. 

■ SVSDB relative pointer to the ILT. 

- interrupt status for this device, 
device interrupts. 

■ Hardware Device Controller Status, 
detects an error. Whenever not zero, SI00B logs an 
I/O error and clears this uord. 

■ tine out conpleted flags. If a tineout occurs in response 
to a tifier request type X20 (I/O request), the sign bit 

is set in this uord. The Ifl bit in OFLFIG is also set, 
and the Monitor for this device is awakened. (Only used 
if tiner services are requested. Dust be uord 88 if tiner 
services are requested.) 



Set each tine the 
Set uhen the driver 
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DIT For 79O5/7906/7920/7925 

0 1 2 3 4 5 6 7 



0 


1 1 1 1 1 II 1 J 1 1 1 
— |— l — l 1--| |— -|-— | — |--|- 

01 1IACTIREQ! CD| H I 0| I/O I IRK I 1 I 0| Oj 

III l mutt I monrl I III 
III! 1UNIT | |PR0G| | III 


STATE 


I 0 
| 


DFLBG 




NEXT DITP 




I 1 


OLIHK 




LunKtNl IHLUVfcJ DISC REQUEST 




12 


DIOQP 




LOGICAL DEVICE HJrtBER 




1 3 


DLDEV 


4 1 


DLTP 




1 4 


DDLTP 


51 


ILTP 




1 6 


DILTP 


61 


-1 UHEN POUER FAIL 




1 6 


DRQST 


7| 


It OF ERROR UORDS 10 LOG I DIT REL UDDR 


TO LOB 


I 7 


DSERR 


81 


INDEX OF FIRST REQUEST IN QUEUE 




110 


DflAFIQ 


91 


INDEX OF LAST REQUEST IN QUEUE 




111 


DflAHQT 


10| 


IOT I/////////////////////////! PHYSICAL UNIT tt 


112 


DUNIT 


111 


SIO PROGRAM-RELATIVE ABORT ADDRESS 




113 


DLOGSIOP 


121 
131 


CURRENT PHYSICAL 
DISK ADDRESS 




114 
115 


CPDR 




CURRENT DATA BUFFER ADDRESS 




116 


CDBfl 


15| 


UORD COUNT REMAINING 




|17 


UCR 


16 


CURRENT UORD COUNT 








171 


SYSBUF INDEX 




121 


SYSBUFA 


181 


STATUS 1 RETURN 




|22 


STHT1 


19| 


STATUS 2 RETURN 




I23 


STAT2 


201 


CYL 




1 24 


CEDA 


211 


HEAD | SECTOR 




1 25 




22| 


STATUS 1 RETURN 




1 \ 
1 1 




23! 


CYL 




1 1 
1 1 
t i 
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DIT for 7905/7906/7920/7925 (Cont.) 



| 

24 1 HEAD | 



25! 

I- 
26! 



28 1 

I- 
29 1 

I- 
30I 

I 

311 

I- 
321 

I- 
331 
341 

I- 
351 

I- 
361 



DISPLACEMENT 
PATT 1 
PRTT 2 
PATT 3 



SECTOR COUNT TO TRANSFER 
INITIALIZE ADDRESS 



-I I 
I I 
-I REQUEST 
I SYNDROME 

I 

I 

I 

I 

I 

I 

/ 

35 SCOUNT 

36 INITADR 

1 37 
-I 



I / 0 

Error and Retry Information 

0 1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 
l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l 
I D| S| E| HI U| T| 0| C|CL| 0 0 0 Olretry cnt QUI! 

1 1 

D - retry deternination 

S - request syndrone 

E - request error infomation 

n - update track nap 

U - uriting track nap 

C - issued a recalibration 

CL- driver issuing channel clear 

T - tineout wait 

NOTE: Integrated Cartridge Tape's DIT has the sane fomat. 



CNTLR STATUS AFTER SEEK 
IN CHANNEL PROGRAM 



CPVA UORD 0 UPON CHANNEL ABORT 
CURRENT LOGICAL SECTOR ADDRESS 



I LI40 DMISC 
1 

141 SEEKSTAT 

I42 
— -I 

|43 DLOGERROR 
1 

|44 CLDR 



DMISC 

(15:1) L'STAT'ERR - 



Last transfer ended in error. 



IOT - I/O Devices 

0 - non-HP-IB 

1 - HP-IB Systens 

2 - unused 

3 - unused 
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CS 80 Disc Device Info mat ion Table (PIT) 

Then is one OIT per physical device. If a physical device represents nore 
than one logical device, the logical device nuttber is obtained f run the 100 
elenent. for the CS'80 disc controller, there will only be one device. The 
following diagran shows the OIT used by the CS'80 disc driver. 

0 1 2 3 4 5 6 ? 8 3 10 11 12 13 14 15 tlNEIIONIC 

+ — + — 4 — 4 — 4 — 4 — 4 — + — 4 — 4 — + — 4 — 4 — + — 4 — + — + 

0 I TH I DS | RC | RQ | CD | 0| O|I0|Ifl|N0|ST| 0| STATE | OF LAG 



1i SYSD8 relative pointer to the OIT for the next I DUNK | device requesting 
this resource or service I 



2 | Current request index | OCURREQP 

+ 4 

3! Logical device nunber | DLDEV 

+ 4 

4| SYSDB relative pointer to Device Linkage Table! DDLTP 
t + 

5| SYSDB relative pointer to Intrp Linka'ge Table | DILTP 

+ - + 

6| DSTflT is -1 when a systen pouerfail occurred | DSTAT 

* ---+ 

7| Hardware error status. Set uhen the driver | DSERR | detects an error. 
Whenever <>0, the driver | | nonitor logs an I/O error and clears this 
uord| 



110 1 index of first request in queue 

* 

X11f index of last request in queue 

+ + 4 

21 2 i IOT | Physical Unit * 



I DQHEfiD 1 

-4 

I DQTRIL 1 
| DUNIT 



113] Table relative index to systen buffer elenent IDSBUFADDR 

+ + 

X14| High order logical sector address of bad blk | DBRDBLK1 

+ 4 

S£15| Low order logical sector address of bad blk | D8RDBLK2 

+ —4 

X16| Byte transfer left uhen bad block occurred | DBRDXFER 

+ 4 

X17| Harduare logged error status - CPVfl (0) i DLOGERROR 

t 4 

120 | Channel progran aborted relative offset | DSIQPSTOP 



+ 



Z21| Disc status (20 bytes)-Logged on status error | DSTRTUS 

+ 4 

- I 

+ 4 

■ I 

+ 4 

X33 |LK | IF 1 110 1 | SUBSTRTE I OtIISC 
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X34|RE|DC|DR|EN| 

t — ♦ — 4 — 4 — 4- 

Z36| T1 



iLOCBL STRTEj RPSUOR01 

-4 4 

T2 I RPSU0RD2 



DFLfiG - Flags and request state 

Tft TERM - Set if device is a terminal. DS DISC - If Til = 0 and this 
bit is set then the device is a disc, otherwise device dependent. RC ACTIVE 

- fl Monitor is currently servicing this device. RQ REQUEST - R service 
request is pending while the nonitor is active. 10 IOPROG - Rn I/O Channel 
Progran is running for this device. Ifl IRK - Rn interrupt or response 
has occurred for this device. NO NOTRDY - Go to state X10 after Idle 
Channel Progran is started, ST STURIT - The device nonitor is starting an 
Idle Channel Progran for this device. There is no IDE) associated with this 
type of request. STATE - State of the device nonitor. Specifies the 
next action to be taken in SIODtl in servicing the request: 

0 - start new request 1 - not used 2 - call driver initiator procedure 3 - 
call driver conpletor procedure 4 - not used 5 - process request completed 6 

- initiate device recognition sequence 7 - start operator intervention uait 
210 - uait for interrupt (operator intervention) restart at state 0 XII - 
uait for data segnent freeze, then state 2 X12 - wait for driver initiator to 
be frozen, then allocate controller (state 2) %1 3 - wait for I/O conpletion 
interrupt, then state 3 Z14 - uait for controller, then call driver initiator 
311 5 - not used X16 - wait far initiator Hake present, then state 2 X17 - uait 
for conpletor nake present, then state 3 

DUNK - R SYSDB relative pointer to the next DIT requesting this resource or 
service. 

OCURREQP - R current request sysbase index. 
DUNIT. (0:2) - I/O systen type 

0 - non-HP-IB 1 - HP3000 HP-IB Systens 2 - Unused 3 - Unused 



DLDEV - Logical device nunber of this device. 

DSTRT - Set to a -1 uhen a systen pouerfail has occurred. 
DSERR - Pointer to status to be logged. 

Bits(0:7) - Nunber of words to be logged. Bits(8:15) - Offset relative to 
DITPfO). 

DHISt - Device dependent processing flags 

LOCK'FLC - Lock flag denoting unload status of the disc volurte. 

0 - flllou operator unload to the volune. 1 - Deny operator unload to the 
volune. 

G.00.00 
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IGNORE' INT 'FLG - Ignore unexpected interrupt flag. 

SUBSTRTE - Indicates state of the idle channel progran: 

0 - Nornal idle channel progran uait 1 - Idle request being serviced uait 

DSBUFRDDR - SYSDB relative pointer to the systen buffer elenent used to read 
the OSCT. Zero, if no elenent gotten. 

DBRDBLK1 - High order logical sector address of the bad block for the 
Defective Sector Table (DSCTJ entry. 

08RDBLK2 - Lou order logical sector address of the bad block for the OSCT 
entry. 

WHOXFER - Byte transfer left uhen bad block occurred. 
DLOGERROR - CPVA(O) logged on hardware error status. 

DSIOPSTOP - Stopped channel progran relative offset location due to an error 
in CPVfl(O). 

DSTRTUS - 20 bytes disc status logged on status error. (See CS'80 Disc Drive 
Status). 

RPSUQRD1 - Flags and local state 

RE - Read revision code done. Set if read revision code level is done. DC - 
RPS revision code. Set if controller is "PEP"ed. OR - RPS desirable. Set 
if RPS is desirable. EN - RPS enabled. Set if default value for RPS is en- 
abled. HR - Driver is processing a narginal data error fron the drive. Do 
not return hard error. Local State - State of the local request nade by 
driver 

0 - Ho local request is being processed 1 - Reading rev code 2 - Setting 
default RPS 

RPSU.QRD2 - Default value for RPS 

T1 - Tine to target in hundreds of Microseconds T2 - Window size in hundreds 
of nicroseconds 
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DIT For 7970 naqnetic Tape 



0 1 2 3 4 5 6 7 8 9 10 11 12 
|„j._|„_|___|___|_ (__| |_„|___ iHH 

| 0| 0|RCT|RE0| 0 | fl | 0| I/0|IRK| 0 ! 0| 0| STRTE 
I I I | | I UNIT | fPROGj I I I I 



3| 

I- 
4| 

I- 



NEXT DITP 
IOQP 

LOGICAL DEVICE NUMBER 

DLT PTR 

ILT PTR 

HRRDURRE STRTUS 

ERROR STATUS 

8 1 TIHEQUT FLAGS 

I — ■ 

9| TIMER REQUEST INDEX 

| 

101 IOT I ///////////////////////// | PHYSICAL UNIT # 
111 



6|RU!RUiSH|CEi0Ct 

I 

71 



I- 



13|RB4| RU 



DF LAG 

DUNK 
DIOQP 
DLDEV 
DDLTP 
DILTP 
DSTAT 
DSERR 
DTinE 
DTRQX 
DUNIT 
DDFLRGS 
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IOT - I/O Devices 

0 - non-HP-IB 

1 - HP-IB Systens 

3 - unused 

4 - unused 

DSRVE - Device processing flags 
RU RUBIT - Indicates tape has been rewound. 

RU RUUNLO - Indicates that a rewind/unload uas perforned to allow a 
write- ring Mount. 

SH SHORT - fl short read is in progress. After conpletion of read, 
EOF is checked for and if not present, the requested 
bytes are transferred frcn the short-read buffer to the 
user's buffer. 

CE CESTRT - Channel parity error processing is in progress. 

DC OSFLRG - Transfer used data chaining - used for computing the 
transmission log. 
RU - (DDFLRGS, bit 15) if set, tape is rewound 
RB4 - (bit 14) if set. need to rguind tape before next urite 
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DIT for 7976 flaqnetic Taoe 


0 


1 0 1 A C C 1 3 0 1ft 11 H 11 1J It 
1 C J H 3 C f 5 S 1U 11 l£ 1J 11 11 




There is one DIT per physical device. If a physical device represents (tore 








than one logical device, the logical device nunber is obtained fron the IOQ 


1" 


-_i__| H __|__| H __|__|__ M __|__|„|__|__| 




elenent. The following diagran shows the DIT used for the nag tape driver. 


1 


| | j 1 | | FORUflRDI BHCK | j 




1 R 


B| F| Gj E| S| U| SPACE I SPACE I RETRY | 




0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 HNEH0HIC 


| 


| | 1 1 1 1 COUNTER (COUNTER | COUNTER | 




■*--+—+—+—+—+—+—+—+—*—*—+—+—+—♦—♦—+ 


| — 






0| 0| 0|AC|RQ[ 0|nU| 0|IO|IA| 0| 01 01 STATE I DFLflG 


Uhere 






t— *—+—+—+—+—+—+—+—*— +—+—* + 

1| SYSDB relative pointer to the OIT for the nextj DUNK 


R - 


retry in progress 




| device requesting this resource or service | 




backspace in progress 






F - 


forward space in progress 




Z I SYSDB relative pointer to the first IOQ in | DIOQP 




gap in progress 




I request list for this device I 


E ■ 


backspace on data end-of-file 








short read in progress 




3| Logical device nunber | DLDEV 


U • 


unload tape for write ring installation 








4] SYSDB relative pointer to Device Linkage Tablel DDLTP 








31 oioud relative pmr to interrupt LinKage laoiei uiLir 








c \t>\\ i dii 1 iru 1 1 nr 1 dc 1 1 ricowe 








7| Hardware error status. Set when the driver | DSERR 








I detects an error. Uhenever <>0, the driver | 








1 nonitor logs an I/O error and clears this uordl 








2101 Bit 0 is set at conpletion of tiner | DTIHE 








+-+- + . +„+„+ — - t 

211 1 Interrupt status for this unit. Set by the | DSTRT 








| driver each tine it processes an interrupt. j 








TnT 1 1 1 f 1 1 1 1 1 1 1 1 1 ! 1 1 1 1\ Phutipil unit M 1 

iui \u 1 1 1 1 1 } 1 u 1 1 1 f 1 1 \ rnysicai. unit m \ 








21 3 | Holds the tine out request entry index while | DRQST 








j a tiner is active. 1 








+ + 

214| Error log. Contains 5 valid bytes of status j DLOGERROR 








DFLflG - Flags and request state 








fiC ACTIVE - fi Monitor is currently servicing this device. 








RQ REQUEST - A service request is pending uhile the nonitor is 








active. 








HU HUNIT - This device is on a nulti-unit controller. 








10 IOPROG - An I/O Channel Progran is running for this device. 








IA IRK - Rn interrupt or response has occurred for this device. 








NO NOTRDY - Go to state 210 after Idle Channel Progran is started. 








ST STUftlT - The device nonitor is starting an Idle Channel Progran 








for this device. There is no IOQ associated uith this 








type of request. 
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STATE - State of the device Monitor. Soecifies the next action 




DSTflT - Rag tape controller status 




to be taken in SIQDR in servicing the request: 






0 - start new request 




BITS USE 




1 - not used 








2 - call driver initiator procedure 




0 END OF FILE (EOF) 




3 - call driver conpletor procedure 








4 - not used 




1 BEGINNING OF TAPE (BOT) / LOAD POINT (LP) 




5 - process request conpleted 




2 END OF TAPE (EOT) 




6 - initiate device recognition sequence 




3 SINGLE TRACK ERROR (NOT LOGGED FOR READS) 




7 - start operator intervention uait 








210 - uait for interrupt (operator intervention) 




4 C0HHAND REJECT (REJECT) 




restart at state 0 




5 FILE PROTECT (NOT URITE ENABLED; NO URITE RING) 




21 1 - usit for data segnent freeze, then state I 




6 HULTIPLE TRACK ERROR (UTE) 




212 - uait for driver initiator to be frozen, then 








allocate controller (state 2) 




7 UNIT ONLINE 




213 - uait for I/O conpletion interrupt, then state 3 




S OCR (6250 8PI DENSITY) 




114 - uait for controller, then call driver initiator 




9 UNIT NUnBER (ItSB) 




215 - not used 








21 G - uait for initiator nake present, then state 2 




10 UNIT NUilBER (LSB) 




217 - uait for conpletor nake present, then state 3 




11 TiniNG ERROR 






12 TAPE RUNAUAY 


DSflVE 


- Device processing flags 




13 REWINDING- * 


RU 


RUBIT - Indicates tape has been rewound. 




IIUTT OIKV rt* fOCDflDTCri 09 MUTT UnT MOnV^ 

l*i UNi 1 OUST M IKtrUKitLI Hi Unil hUl KLnDTj 


RU 


RIJUNLD - Indicates that a reuind/unload was perforned to allow a 




15 INTERFACE BUSY * 




urite-ring nount. 






SH 


SHORT - fl short read is in progress. After conpletion of read, 








EOF is checked for and if not present, the requested 








bytes are transferred fron the short-read buffer to the 








user's buffer. 






DC 


OSFLflG - Transfer used data chaining - used for conputing the 








transnission log. 






PF 


POtiER - Device power up indication. 








G.00.00 




G.0O.00 




13- 35 




13- 36 



I / 0 



Card Reader PIT 

0 12 3 4 5 S 7 8 9 10 11 12 15 

I — I— I | — | 1 — | 1 — | — | 

I 0| 0fRCT|REQ| 0 | 0 | | I/O I IFIK | REfiO I NR| | HSTRTE 
I I I I I I I IPROCI |00NE|I1SG| | 

I 

1 1 oitp unk to next on 

I 

21 IMP POINTER TO 1st REQUEST 

i 

31 LOGICAL DEVICE NUHBER 

I 

4| DRIVER LINKRGE TABLE POINTER 

I 

5| INTERRUPT LINKfiOE TR8LE POINTER 

I - 

6| (SEE BE LOU) 

I " 

7 1 ERROR STATUS IF HOT 0 

I - 

X10I REQUESTED UORD COUNT 

I - 

*m miiuiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiimimiiiiiiiiiii 

Z12j IOT I ///////////////////////// I PHVSICRL UNIl"# 
DSTRT bits: 



8IT0=SI0 OK 
BIT1=0 

BIT2=INT PENDING 
BIT3=TIHINC ERROR 
8IT4=UGHT OARK CHECK 
BITS 5-6 = 00 COLUMN BINARY nOOE 
01 UNUSED 

10 PACKED BINARY flOOE 

11 HOLLERITH-TO-flSCII HOOE 
BIT7=C0I1PRRE ERROR 

BIT8=E0F DETECTED 
BITS 9-10 = 00 NORHAL 

01 HOPPER ErtPTY 

10 UNUSED 

11 STACKER FULL 
eiT11=IHVAH0 HOLLERITH 
BIT12=PICK FAIL OR I10T0R CHECK 
BIT13=TEST 

8IT14=TR0UBLE 
BIT15=N0T READY 



OF LAG 

OUNK 
OIOQP 
DLDEV 
ODLTP 
DILTP 
DSTAT 
DSERR 
DTIflE 
DTRQX 
DUNIT 
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Card Reader PIT Field Definitions 
PFLAG - Flags and device state 

ACTIVE flonitor is currently active servicing this device. 

REQUEST Service For this device Mas requested uhile the nonitor uas active. 

IQPRQG SIO progran in progress. 

IAK Interrupt occurred or request aborted or preempted. 

REBDOONE Previous read resulted in an EOF uith a backup save 
requested. The data has been saved in an auxiliary 
buffer and uill be passed back on the next read request. 

HRtlESSAGE Set when a not ready nessage has been issued, and cleared 
when the reader is found ready. Used to prevent nultiple 
Not Ready messages uhen power is turned on. 

RSTATE nonitor State. See SlOCfl specifications for details. 

PUNK - SYSP8 relative pointer to the D1T for the next device 
requesting service for this resource. 



OIOQP - SYSOB relative pointer to the first IOQ elenent in the request 
list for this device. 



DLDEV - Logical device nunber and unit nunber. 



UNIT 
LDEVN 



Unit nunber of device. 
Logical device nunber. 



DDLTP - SYSOB relative pointer to driver linkage table (DLT). 



■ Device interrupt status. Contains the device interrupt status 
at the last interrupt. See hardware ERS for details. 

■ Device interrupt error status. If not zero, then holds the 
device interrupt status fron an operation uith an erroneous 
completion status. Causes SIODtt to log an error. 



DUCNT - Holds the requested transfer count in words. 
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Device Infornation Table for HP-IB Card Reader 

There is one DIT per physical device. If a physical device represents nore 
than one logical device, the logical device nunber is obtained fron the IOQ 
elenent. The follouing diagran shous the PIT used For the card reader 
driver. 



I / 0 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

4 — 4 — 4-- + — + — 4 — 4 — 4 — 4 — 4 — 4 — 4 — 4 — 4 — 4 — 4 — 4 

0| Ol OIACIRQI Olfflll 0!IO|IR|NO|ST| 0! STATE I 

4— 4 — 4—4 — 4 — 4 — 4— 4— 4— 4— 4 — 4 — 4 4 

11 SYSOB relative pointer to the DIT for the next I 
! device requesting this resource or service I 
+ 4 

2| IOQ table relative index to the first IOQ in | 
I request list for this device 

4 + + + 

3| Logical device nunber | 

4 4 4 + 

4 1 SYSOB relative pointer to Device Linkage Table I 

4 1 

51 SYSDB relative pntr to Interrupt Linkage Tablei 

4 + 

61RDIHFI | 

4 + 

7| Harduare error status. Set uhen the driver | 
I detects an error. Uhenever <>0, the driver j 
I nonitor logs an I/O error and clears this uordi 



X10I Not Used 

4 — 4 — 4 — 4 — 4 — + 

X11| Request uord count 



X12 
Z13 



IOT I/////////////////I Physical unit II I 

I 

Device Status. Read fron device during ! 
each execution of the channel program I 



X14! Logging will be done fron here. 



nwnoNit 

Of LAG 
DUNK 

DIOOP 

DLDEV 
DDLTP 
DILTP 
PSRVE 
DSERR 

PTII1E 
PUCNT 
PUNIT 
DSTAT 

DLOGERROR 



STATE - State of the device nonitor. Specifies the next action 
to be taken in SIOOIJ in servicing the request: 

0 - start neu request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver conpletor procedure 

4 - not used 

5 - process request conpleted 

6 - initiate device recognition sequence 

7 - start operator intervention uait 

3E10 - uait for interrupt (operator intervention) 
restart at state 0 

111 - uait for data segnent freeze, then state 2 

112 - uait for driver initiator to be frozen, then 

allocate controller (state 2) 
Z13 - uait for I/O conpletion interrupt, then state 3 
Z14 - uait for controller, then call driver initiator 
Z15 - not used 

Z16 - uait for initiator nake present, then state 2 
XI? - uait for conpletor hake present, then state 3 

DLDEV - Device logical device nunber 
IOT I/O TYPE - I/O Systen type 

0 * Series II / III I/O systen 

1 - HP-IB Systens 

2 - unused 

3 - unused 

DSflVE - Device processing flags 
RO REBDDONE - A card has already been read. 
AF HBORTFLAG - A device clear has already been sent for 
this series of aborted IOOs. 



RQ REQUEST - 

n\S I1UNIT • 

10 I0PROG • 

IA IRK 

NO NOTRDY • 

ST STU6IT • 



OFLAG - Flags and request state 
AC ACTIVE - R nonitor is currently servicing this device. 

■ R service request is pending uhile the nonitor is active. 

■ This device is on a nulti-unit controller. 
Rn I/O Channel Progran is running For this device. 
Rn interrupt or response has occurred for this device. 
Go to state X10 after Idle Channel Progran is started. 
The device Monitor is starting an Idle Channel Progran 
for this device. There is no 100 associated uith this 
type fjf request. 
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2608 Line Printer DIT (HP-IB Svstens) 


STRTE - State of the device nonitor. Specifies the next action 


to be taken in SI0DF1 in servicing the request: 




0 - start neu request 


There is one DIT per physical device. If a physical device represents nore 


1 - not used 


than one logical device, the logical device nunber is obtained fron the IOQ 


2 - call driver initiator procedure 


elenent (however, there is only one device per 2608 controller.) The follou- 


3 - call driver conpletor procedure 


ing diagrari shows the DIT used for the 2608 line printer driver. 


4 - not used 


5 - process request conpleted 


0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 tlNEHONIC 


6 - initiate device recognition sequence 




7 - start operator intervention wait 


0| 0| 0|RCiR0| 01 01 Q|IG|IR|NO|ST| 0| STATE 1 DFLAG 


X10 - wait for interrupt (operator intervention) 




restart at state 0 


1| SYSDB relative pointer to the DIT for the next| DUNK 


%11 - uait for data segnent freeze, then state 2 


t device requesting this resource or service I 


212 - uait for driver initiator to be frozen, then 




allocate controller (state 2) 


2| IOQ table relative index to the First IOQ in | DIGQP 


213 - uait for I/O conpletion interrupt, then state 3 


| request list for this device I 


214 - uait for controller, then call driver initiator 


+ + + + 


11 5 - not used 


31 Logical device nunber | DLDEV 


216 - uait for initiator Hake present, then state 2 


t + + + 


217 - uait for conpletor nake present, then state 3 


4| SYSDB relative pointer to Device Linkage Tablet DDLTP 






DLDEV - I/O systen type, unit and logical device nunber 


5| SYSDB relative pntr to Interrupt Linkage Table) DILTP 


IOT I/O TYPE- Type of I/O systen 


+ + 


0 - HP3000 Series II/III 


E]Vn] | TAB | |PS|FL|TP| DSfiVE 


1 - HP3000 HP-IB Systens 




2 - unused 


?| HardMare error pointer. Set when the driver | DSERR 


3 - unused 


I detects an error, lihenever <>0. the driver [ 




1 rtonitor logs an I/O error and clea rs this uo rd [ 


DSAVE - Device processing flags 




Vfl VFCtIDD - VFC has been nodified. 


X1Q| Bit 0 is set at conpletion of tiner j DTIF1E 


TAB TflBDFAULT - Systen tab default. 




PS PRESPflCE - Last request used prespacing. 


Holds the tine out request entry index uhile I DRQST 


FL FULL - Line printer buffer is full. 




TP TOP - Printer is at top of font 


Z12[ IOT I UUUiUlUmtl 1 Physical Unit K I OUNIT 




X13I Harduare logged error status I DLOGERROR 




DFLAG - Flags and request state 




AC ACTIVE - A nonitor is currently servicing this device. 




RQ REQUEST - A service request is pending uhile the Monitor is 




active. 




10 I0PR0G - An I/O Channel Prograti is running for this device. 




IA IRK - An interrupt or response has occurred for this device. 




m NOTRDY - Go to state %10 after Idle Channel Progran is started. 




ST STUAIT - The device nonitor is starting an Idle Channel Progran 




for this device. There is no IOQ associated uith this 




type of request. 
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2608 Line Printer Status 


HP 2619A or 2613 Line Printer DIT (HP-IB Systens) 


BYTE 1 & BYTE 2: 




BITS USE 


There is one DIT per physical device. If a physical device represents 


nore than one logical device, the logical device nunber is obtained 


0 OH LINE 


fron the IOQ elenent (hoiiever, there is only one device per 2631 




controller.) The following diagrati shows the DIT used for the 


1 NOT READY 


2631 line printer driver. 


2 VFC CHANNEL 9 (BOTTOH OF FORH) 




3 VFC CHANNEL 12 (TOP OF F0RH) 


0 1 2 3 4 6 6 7 8 9 10 11 12 13 14 15 fttOQNIC 


4 VfC INITIALIZED 


0| 0| 0|AC|RQ| 01 0| 0|I01IA|NC|ST| 0| STRTE I DFLAG 


a 0/6 LiNti rtK INLil 




6 (NOT USED) 


1| SYSDB relative pointer to the DIT for the nextl DLINK 


I device requesting this resource or service I 


7 TOMER RESTORED/UNIT RESET 




6 UN LiNc 


2 1 100 table relative index to the first IOQ in | DIOQP 


9 PRINT HECH ERROR 


| request list for this device I 


10 SELF TEST FAILURE 


3| Logical device nunber | DLDEV 






12 SELF TEST tlODE 


4j SYSDB relative pointer to Device Linkage Tablel DDLTP 


13 6/8 LPI 


5| SYSDB relative pntr to Interrupt Linkage Tablel DILTP 


14 PLRTEN/RIB80N ERROR 




15 (NOT USED) 


6| |BJ|nB|PS|FL|TP| DSfiVE 


DVTC 3. B9Tl(T Mf)j)f 


7| Harduare error status. Set uhen the driver | DSERR 


BITS 0-T MODE NUBBER 


| detects an error. Whenever <>0, the driver j 


BYTE 4: PRIMARY/SECONDARY 


I Monitor logs an I/O error and clears this wordl 


BITS 0-3 SECONOflRV CHARACTER SET CODE 




BITS 4-7 PRIHRRY CHRRRCTES SET CODE 


Z10| Bit 0 is set at conpletion of tiner | DTIftE 


BYTE 5: SELF TEST 




BITS 0 PRSS FOIL 


Z11| Holds the tine out request entry index uhile | DRQST 


BITS 1-7 SUBTEST NUrlBER 


| a tiner is active. I 


BYTE 6: 6 LPI DOT ROU COUNT 




BYTE 7: 6 LPI FORn LINE NUBBER 


Z12| IOT I ///////////////// I Physical unit » ! DUNIT 


BYTE S: 6 LPI FORn LENGTH IN LINES 




BYTE 9: 8 LPI DOT ROU COUNT 


Z131 Harduare logged error status I DLOGERROR 


BYTE 10: 8 LPI FORH LINE NUH8ER 




BYTE 11: 8 LPI FOR". LENGTH IN LINES 




BYTE 12: FIRnURRE IDENTIFICATION CODE 




BYTE 20: POUER-UP LANGUAGE 


DFLAG - Flags and request state 


BITS 0-3 SECONDARY CHARACTER SET CODE 


RC ACTIVE - A nonitor is currently servicing this device. 


BITS 4-7 PRlnfiRY CHARACTER SET CODE 


RQ REQUEST - A service request is pending uhile the nonitor is 




active. 




10 IOPROG - An I/O Channel Progran is running for this device. 




IA IflK - An interrupt or response has occurred for this device. 




NO NOTRDY - Go to state Z10 after Idle Channel Progran is started. 




ST STUAIT - The device nonitor is starting an Idle Channel Progran 




for this device. There is no IOQ associated with this 




type of request. 
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STATE - Stats of the device nonitor. Specifies the next action 
to be taken in SIODH in servicing the request: 

0 - start neu request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver conpletor procedure 

4 - not used 

5 - process request conpleted 

6 - initiate device recognition sequence 

7 - start operator intervention Halt 

Z10 - uait for interrupt (operator intervention) 

restart at state 0 
X11 - uait for data segnent freeze, then state 2 
212 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
X13 - uait for I/O completion interrupt, then state 3 
X14 - uait for controller, then call driver initiator 
215 - not used 

5S16 - uait for initiator flake present, then state 2 
X17 - uait for conpletor nake present, then state 3 

OLDEV - I/O systefl type, unit and logical device nunber 
I0T I/O TVPE • Type of I/O systen 

0 - RP3000 Series 2/3 

1 - HP3000 HP-IB Systems 

2 - Unused 

3 - Unused 



DSWE 
BJ 



A8 R80RT 



PS 
FL 
TP 



' Device processing flags 

BETJOB - Between jobs flag. If set, suppress 
Pouerfail nessage. 

- Abort (caused by Pouerfail or Operator) 
has occurred. 

- Last request used prespacing. 

- Line printer buffer is full. 

- Printer is at top of fom 



PRESPACE 

FULL 

TOP 



HP 2680B/2688A PIT 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

4 — 4— 4«4"+--4--4" 4--4— 4--+-- 4--4--4— 4«4 — 

OITO 10 >0 IACIRQI0 !0 !SP!CP!IA!NR!SU! ! STATE 
1 ! POINTER TO NEXT OIT 



INDEX TO ACTIVE 100 OR ZERO 
LOGICAL DEVICE HUflBER 
DRIVER LINKAGE TABLE POINTER 
INTERRUPT LINKAGE TABLE POINTER 



! SPECIAL ERROR CONDITIONS TO BE LOGGED 
! ERROR LOGGING INFORMATION 

!T ! TIHE0UT INDICATION IN BIT 0 
! TWER REQUEST INDEX (TRL) OR ZERO 

10 ! I0T !/////////////////! PHYSICAL UNIT « 

t . 

11 ! CURRENT DATA WRITE BYTE COUNT 

12 ! CURRENT DATA UORD COUNT 



13 ! ft OF UOROS LEFT TO TRANSFER 

14 ! BUFFER OFFSET FOR NEXT II OF UORDS TO XFER. 

15 ! !0 

16 i I/O STATUS BLOCK UORD 1 GETS LOGGED FROfl HERE 
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DF LAG 

DUNK 

0I0QP 

DLDEV 

DDLTP 

DILTP 

OSTAT 

DSERft 

DTIME 

DTRLX 

DUNIT 

DCBCNT 

DCUCNT 

ORCNT 

DOFFSET 

DDEBUG 

DLOGBUFFER 



17 ! I/O STATUS BLOCK UORD 3 GETS LOGGED FROfl HERE 
U/33 ! I/O STATUS ARER (16 UORDS, SEE DEFINITION) 

4—4— 4—4— 4— 4—4— 4— 4— 4— 4—4— 4— 4—4— 4—4 

DFLAG - DEVICE RELATIVE FLAGS. 

AC ACTIVE BIT. 1 IMPLIES A (10NITOR CURRENTLY 

SERVICING THIS DEVICE. 
RQ REQUEST BIT. 1 IMPLIES SERVICE REQUESTED 

UKILE nONITQR IS ACTIVE. 
SP SIO PREEflPTION. IF SET THEN A PREEMPTIVE 

REQUEST HAS BEEN QUEUED FOR THIS DEVICE. 

PREEMPT CODE IS SET IN 100 ELEMENT, 
CP CHANNEL PROGRAM IN PROGRESS. IF SET, THEN 

A CHANNEL PROGRAM IS CURRENTLY EXECUTING. 
IA IF SET, AN INTERRUPT OR RESPONSE HAS OCCURRED. 
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NR IF SET, DEVICE IS IN A NOT READY OR OPERATOR UAIT. 

SU IF SET, AN IDLE CHANNEL PROGRAM SHOULD BE STARTED 

FOR THIS DEVICE. 
MSTATE CURRENT DRIVER STATE AS DEFINED BY THE MONITOR. 

ALLOWABLE STATES ARE: 

0 - START REQUEST 

1 - NOT USE0(BUT RESERVED) 

2 - CALL DRIVER INITIATOR 

3 - CALL DRIVER CONPLETOR 

4 - UNUS£D(BUT RESERVED) 

5 - COMPLETE REQUEST. -PERHAPS RETURN TO USER. 

6 - UNEXPECTED INTERRUPT OCCURRED. 

7 - START OPERATOR INTERVENTION UAIT. 
110 - UNITING (ON OPERATOR). RESTART AT 0. 

11 - UNITING (DATA BAKEPRESEMT/FREEZING) 

12 - WAITING (INITIATOR CODE MAKEPRESEHT/FREEZE) 

13 - WAITING (FOR COMPlfTIOH INTERRUPT) 

14 - WAITING (FOR DEVICE CONTROLLER AVAILABILITY) 

15 - UHUSED(BUT RESERVED) 

16 - WAITING (INITIATOR CODE MRKEPRESENT) 

17 - WAITING (COMPLETOR CODE MRKEPRESENT) 

DLDEV - I/O SYSTEM TYPE, UNIT AND LOGICAL DEVICE NUMBER. 
IOT I/O SYSTEM TYPE. 

0 - HP3000 SERIES II/III (SIO/DIO) 

1 - HP-IB Systens 

2 - RESERVED 

3 - RESERVED 

DCBCNT - CURRENT BYTE COUNT TO BE TRANSFERRED. 

DCWCNT - CURRENT UORO COUNT TO BE TRANSFERRED. 

DRCNT - REMAINING WORD COUNT TO TRANSFER. 

DOFFSET - OFFSET IK BUFFER OF NEXT II WORDS TO TRANSFER. 

DDEBUG - IF BIT 15=1 THEN DEBUGGING INFO UILL BE SENT TO CONSOLE 

DLOGBUFFER - STATUS UORDS 1 4 3 ARE MOVED HERE TO BE LOGGED 
IF THEY WERE LOGGED FROM THE I/O STATUS BLOCK 
THEIR CONTENTS MIGHT BE CHANGED BEFORE THEY 
WERE LOGGED. 

DIOSTRT - I/O STATUS AREA 16 UORDS, SEE I/O STATUS BLOCK DEFINITION. 



I / 0 

I/O Status Block 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



0 !0 1--THE "OR" OF UORDS 1/15 IS LOCATED HERE- — 

4—4— 4—4— 4~4--4~4— 4—4— 4~4— 4—4—4 — 4 

1 !OF!MS!PU!PE!TE> !!!!!!!!!! 

4—4—4—4—4—4—4—4—4—4—4—4—4—4—4—4 — 

2 ! ! ! ! ! ! (RESERVED) !!!!!! 

3 ! MCS FAULT NUMBER 

4—4—4—4—4—4—4—4—4—4—4—4—4—4—4—4—4 

4 !CL!FL!VUCU!FU!VU!IL!IP!ST!SB!IR!MP!NJ!Nfl!TL!HC 

4—4—4—4—4—4—4—+ — + h— 4— 4— 4— 4— 4— 4 

5 !LP!PF!NC! ! ! (RESERVED) !!!(!! 

6 ! ! ! ! ! ! (RESERVED) !!!!!! 

4—4—4—4—4—4—4—4—4—4—4—4—4—4—4—4 

7 ! 



(RESERVED) 



! i i i 

-4 — 4 — 4- 

! ! ! ! (RESERVED) !!!!!! 



(RESERVED) 



i i t i i 



10 i ! ! ! I i (RESERVED) !!>!!! 



11 I ! ! ! ! ! (RESERVED) !!!!!! 



12 ! 

4 — 

13 ! 



RECORD NUMBER OF ERROR 
IF UORD 4 IS 
NON-ZERO 



14 ! SHEET NUMBER OF ERROR IF UORO 4 IS NON-ZERO 
+-- OR 

15 ! LAST SHEET TRANSFERRED IF "JOB" & POUER-ON 



DIT 17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
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WORD 0 - EACH BIT IS THE 'OR' OF ONE WORD IN THE TABLE (EXCEPT 
BIT 0 WHICH IS NOT USED). THEREFORE, BIT .(1:1) IS SET 
IF UORO 1 IN THE TABLE IS NON-ZERO. 

UORD 1 - BIT* 0 - (OF) ONLINE/OFFLINE BIT. 

1 - (MS) MESSAGE BEING DISPLAYED ON THE 2680A/2688A CONSOLE. 

2 - (PU) POWER UP COMPLETED SINCE LAST I/O STATUS READ. 

3 - (PE) PARITY ERROR DETECTED OH PHI COMMAND. 

4 - (TE) TRANSMISSION ERROR DETECTED IN THE PRINTER. 
5/15 - RESERVED. UNUSED. 

UORD 2 - NOT USED. RESERVED. 

UOSD 3 - MCS FAULT NUMBER. CONTAINS AN INTEGER DESCRIBING THF L5ST 
FAULT TO OCCUR SINCE THE LAST TIME THE 1/0 STATUS UAS READ 
OR THE HP 2680A/2688A UAS POUERED DOWN. IF THE UORO IS ZERO THERE 
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IS NO MCS FAULT. SEE DCS ERS FOR A DESCRIPTION OF THE MCS 
FRULT NUMBERS. 

UORD 4 - BIT= 0 - (CD NO ROM FOR ATTEMPTED CHARACTER SET LOAD. 

1 - (FL) HO ROOn FOR ATTEMPTED FORM LORD. 

2 - (VL) NO ROOD FOR ATTEMPTED VFC LORD. 

3 - (CU) RTTEnPT TO PRINT DRTR AND THERE IS HO CURRENTLY 

SELECTED CHARACTER SET. 

4 - (FU) RTTEnPT TO SELECT AN UNDEFINED FORM SET. 

5 - (VU) RTTEnPT TO PRINT DflTR AND THERE IS NO CURRENTLY 

SELECTED VFC SET. 

6 - (IL) RTTEnPT TO PRINT DflTR AND THERE IS NO CURRENTLY 

SELECTED LOGICAL PAGE TflBLE (LPT) ENTRY. 

7 - (IP) RTTEnPT TO IWE PEN OFF THE LOGICAL PAGE. 

8 - (ST) THE 2680A/2688A COULD NOT PROCESS ALL OF THE DATA 

BEFORE IT UAS SUPPOSED TO BE TRANSFERRED TO THE 
DRUn/PAPER. DATA UAS LOST! 

9 - (SB) SPOOLER BLOCK CONTAINS FORMAT ERROR. 

10 - (IR) INVALID RECOVERY BLOCK RECEIVED FROI! SPOOLER. 

11 - (np) maxmum nubber of copies per physical page 

HRS BEEH EXCEEDED. THIS IS A RESULT OF THE 
SPOOLER PROCESS SETTING THE MAXWUM COPIES PER 
PAGE UITH FUNCTION CODE 132. 

12 - (NJ) A COHn AND OR FUNCTION CODE UAS RECEIVED UHEN NO 

"JOB" UAS IN PROGRESS. THE COnnAND OR FUNCTION UAS 
IGNORED BY THE DCS. 

13 - (Nn) NO MEnORY. 26S0A/2688A OYNAHIC MEHORY ALLOCATION HAS 

DETECTED THAT flAIN nEflORY IS COMPLETELY OCCUPIED UITH 
CHARACTER SETS, VFC'S, FORHS AND DATA SUCH THAT THE 
2680A/2688R CANNOT PROCESS THE CURRENT INPUT DATA. DATA 
UILL BE LOST! 

14 - (TL) ATTEnPT TO PRINT DATA AND THERE ARE MORE THAN 

THE MAXMUM BLLOUABLE LOGICAL PAGE TABLE (LPT) 
ENTRIES SELECTED. 

15 - (NC) A NON-EXISTENT VFC CHANNEL UAS SKIPPED TO. 

UORD 5 - BIT= C - (LP) LOGICAL PAGE TRUNCATED TO FIT PHYSICAL PAGE. 

1 - (PF) PAGE SI2E REQUIRED 8Y PROGRAMMER DID NOT 

HATCH PAGE SIZE SET 8Y OPERATOR. OPERATOR PAGE 
SIZE PREVAILS. 

2 - (NC) NO CHARACTER SET SELECTED. 



UOROS 6/11 
UORDS 12/13 



NOT USED BUT RESERVED FOR FUTURE USE. 

■ THE RECORD NUHBER UHICH CONTAINS THE OFFENDING ERROR 
AS DEFINED BY UORD FOUR. IF A POUER FAIL OCCURS DURING 
A "JOB" , THE POUER FAIL BIT IS SET AND A SHEET NUMBER IS 
MADE AVAILB8LE IN UORDS FOURTEEN AND FIFTEEN. HOUEVER, 
THE RECORD NUMBER IS LOST AND CANNOT BE REPORTED. THESE 
UORDS OCCUR IN R "JOB" ONLY. 



UORDS 14/15 - THE SHEET NUMBER ON UHICH THE ERROR OCCURRED RS DEFINED 
BY UORD FDUR. IF AN ERROR OCCURS IN THE ENVIRONMENT FILE 
AT THE START OF A "JOB" , THEN THIS NUMBER UILL BE ZERO. 

G.00.00 
13- 48 



IN ADDITION, UHEN A POUER FAIL OCCURS DURING A "JOB" 
THE POUER ON BIT IS SET IN UORD ONE AND THE SHEET 
NUMBER OF THE LAST SUCCESSFULLY TRANSFERRED PAGE IS 
PLRCED HERE. THIS INFORMATION IS FOR USE BY THE 
SPOOLER SHOULD A RECOVERY OF fl "JOB" BE DETERMINED. 
THESE UORDS OCCUR IN "JOB" ONLY. 



ALL UORDS OF THE I/O STATUS ARE CLEARED UHENEVER THE STATUS BLOCK 
IS RETURNED TO THE HOST. IT IS UP TO THE HOST CPU TO RETAIN ANY 
ONGOING STATUS BITS REQUIRED. 

QHISC - 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

♦—+—+--+ +--+--+—+ — + + +--+ 

I0Q3 !MB!RB!RB!IO!TO! ! XFER ! PARITY ! ! QHISC 



UHERE: 
.(0:1) 



USER REQUESTED TRANSFER IN EXCESS OF 4096 
UORDS. THE DRIVER CAN URITE UP TO 4096 UORDS 
TO THE 2680R/2688A. IN ORDER TO HANDLE UP TO 32K 
UORDS, MULTIPLE URITES ARE USED UITHOUT A 
RETURN TO THE USER UHO CALLED THE DRIVER. 
THIS BIT INDICATES THAT MULTIPLE URITES ARE 
BEING DONE TO THE 2680A/2688A. 

THE CURRENT URITE BLOCK MUST BE RETRIED. 

USER REQUESTED ABORT IN PROGRESS FLAG. 

I/O STATUS HAS BEEN READ AND IS AVAILABLE. 

GENERAL I/O CONTROLLER TIMED OUT. 

RESERVED NOT CURRENTLY USED. 

XFER 2680A/2688A TRANSFER ERROR COUNTER. 

CHANNEL PROGRAM COMMAND PARITY ERROR COUNTER. 

NOT CURRENTLY USED. 



- 10 
• TO 



.(1:1) 
•(2:1) 
.(3:1) 
.(4:1) 
.(5:4) 
.(9:3) 

.(12:3)- PARITY 

.(15:1)- RESERVED 

"NOTE** IN THE ABOVE, SINGLE BIT FIELDS ARE RS DEFINED 
UHEN THE BIT IS A LOGIC "1". 
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Disc Request Table and Disc Requests 



Requests for disc transfers are effected by acquiring an entry fron the Disc 
Request Table (DISCREQTAB), filling the proper information, and calling the 
DISCQMANAGER to link the request into the device's doubly linked request qu 
queue. 

The head and tail of a device's request queue are contained in the 
devices' DIT. 



DISCREQTAB 



I I- 
I DIT |- 
I I- 



I Device's 
I Current 
I Request 



>| First 
I Request 
I in Queue 
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Disc Request Table 



DISCREQTAB DST ENTRY* = 56 (Z70) 
DISCREQTAB PRT = Z1017 



Disc Request Table Entry 0 Fomat 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

DISCREQTABOOI TOTAL ENTRIES 

I 

DISCREQTAB01 I ENTRY SIZE (X21) 

I 

DISCREQTRB02I PRIMARY ENTRIES 

I 

DISCREQTAB03 | IMPEDED PROCESS PCB 

| 

DISCREQTAB04I TABLE INDEX OF HEAD OF AVAILABLE ENTRY UST 

| 

DISCREQTAB05 I TABLE INDEX OF TAIL OF AVAILABLE ENTRY LIST 

I— 

DISCREQTA606I MAX ENTRIES IN USE 

I— 

CURRENT ENTRIES IN USE 



l<> 



OVERFLOUS 
TOTAL REQUESTS 



I Next 
i Request 
I in Queue 



I Last 
->l Request 
I in Queue 



|<>- 
I 

|<>- 



|<>- 



DISCREQTAB07 
DISCREQTAB08 
DISCREGTHB09 

DISCREQTAB10i 

I 

DISCREQTAB1 1 1 SYSBASE INDEX OF HEAD OF DISABLED REQ Q 

I — - 

0ISCREQTA812 I SYSBASE INDEX OF TAIL OF DISABLED REQ Q 

I - 

DISCREQTAB13I SERIAL URITE QUEUE HEAD 

| 

DISCREQTAB14IA I/////////////////1MAX. SERIAL URITE QUEUE 

I - 

DISCREQTRB1 5! /////////////////////////////////////////////// 
I — 

DISCREQTR816I /////////////////////////////////////////////// 



DISCBHEAD 
DISCQTAIL 
SERUQHEAD 
A - Active 
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Disc Request Element Fomat 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



l-l-l-l- 
Uord 00 1 n in ID is 



IB IK II IB 0 |K 



Uord 01 
Uord 02 
Uord 03 
Uord 04 



Uord 06 
Uord 07 
Uord OS 
Uord 09 



|0 |R IB |U 
IS IE |G IF 
IT ID I | 
I I I I 
I I I I 
| 



-I- 



I IB C ID 



U |D 
« I 
K I 
E I 
I 



-I- 



o in 
n IT 

P IB 
IF 



-I--I- 



II ID IS P C ID II II 
U II F U II ID IN 



E 10 A 
U IF I 
E IB 

II 

IL 



-I--I--I- 



R IS IB |L 

R IB | 10 

E IB I |C 

0 I I IB 

I I II 



Uord 11 
Uord 12 
Uord 13 
Uord 14 
Uord 15 
Uord 16 



REQUEST URGENCY CLASS 
LOC-ICfll DEVICE NUtlBER 
I1ISCELLBNE0US 
SI DST (IF PSOCESS DISC I/O) 

BANK (IF SE&HENT TRANSFER) 

OFFSET INTO DRTfl SEC (IF PROCESS DISC I/O) 
ADDRESS IN BANK (IF SEGHENT TRBNSFER) 
UNIT # | FUNCTION 

COUNT/XLQO/CONTROt RETURNS 
P1 (HOOfl IF SEGnEHT TRBNSFER 



P2 (LODfl IF SEGNENT TRANSFER 
Uord 10 //////////////////////////I QUnilFIER I STBTUS 
FREE | PCB NUH8ER 

INDEX OF PREV REQUEST IN QUEUE 
INDEX OF NEXT REQUEST IN QUEUE 



SEOIDENTIFIER (IF SEG TRANSFER) 



DISPLACEHENT OF READ OR URITE FROM SEO BnSE(NII) 



URGCLASS 
LDtVN 

msc 

DSTN 
S'STRCK 

BOOR 

FUNC 

XFERCNT 

PARI 

PBR2 

STAT 

PCBN 

PREVREQP 

KEXTREOP 

SESIDENT 

SEODISP 



Mote: Upon return to Free list, uord (N1) becomes index of next EE 
free entry. 
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Bit 0 


.ABORT 


Request has been aborted externally. 


Bit 1 


.IfflREQ 


Request is For a segnent transfer. 


Bit 2 


.diag 


Diagnostic request (not used). 


Bit 3 


.SBUF 


Systen Buffer. Target is a systeti buffer 
uhose index is relative to the start of 
the SBUF table. 


Bit 4 


.IOURKE 


Uake caller on completion of request. 


Bit 5 


.BLOCKED 


Blocked I/O. Caller is uaited in BTTBCH10 until 
request is completed. 


Bit 6 


.CORPLETEO 


Request has been completed and caller uoken if 
he had specified. 


Bit 7 


.DATAFRZN 


Data segnent has been nade present and is 

frozen. 


Sit 8 


. tlAHERRORO 


I1AI1 error on data segnent nake present. 


Bit 9 


.PREQQUEUED 


Request is queued into disc's req queue 


Bit 10 


. SFfll L 


Start SIO failure in OIP. 


Bit 11 


.PFAIl 


The I/O has been aborted because of a pouerfail. 


Bit 12 


. CURREQ 


Request is device's current request. 


Bit 13 


.DISABLED 


Request is disabled. 


Bit 14 


.LOR 


Request in local DRQ. 


Bit 15 


. INLOCAL 


Buffer DST is in process locality. 


Uord 2 - 
Uord 3 - 


OLOEV.QLDEVN - Logical Device Nunber 
QtlISC - Device dependent. 



Uord 4 

OOSTN - If SVSBUFRs is clear then this is the DST nunber of the target 
data sequent. If bit 0 is set then buffer address is a DB offset 
value instead of segnent relative offset (inplenented for 
NOUAIT 10 and NOBUFF). 

Uord S 

OflDDR - Offset in data segnent or sys buff table to target data buffer. 
Uord 6 

QFUNC.FUNC - Function code and qualifiers as specified by driver. 
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Uord 7 

SXFERCNT-On initiation specifies the uord count if positive or byte 

count if negative. Rt completion of the request this location 
contains the actual transmission count in the sane units as the 
call. Certain control requests return data through this 
location. 

Itord ! 
4PBR1 
Uord 9 
QPBR2 ■ 

wise ■ 

lord 10 

USTAT.PCBN - PCB Nunber of process which nade this request. Zero if 
not associated uith any process and IOQ is to be returned 
by the systen. 

.QUALIFIER - A code uhich Further defies or qualifies the 

general status. Defined by driver. 
.STBTUS - General Status. Indicates current and result state of 
the request according to the follouing codes. 

0 - not started or auaiting conpletion. 

1 - successful conpletion. 

2 - end of file detected. 

3 - unusual condition. 

4 - irrecoverable error. 

NOTE: See I/O Systen Status Returns. 

Uord 11 - bit 0=1 Q elenent is on free list. 



IOQ Table layout 



■ Paraneter one, defined by driver 

■ Paraneter two, defined by driver 

- miscellaneous request dependent storage available to driver. 



0 
1 
2 
3 

— -4> 

I 

..-..5. 
6 
7 
10 
11 
12 
13 



-|-> 



-l-> 



TOTAL • 



ENTRY SIZE 
PRIrtARY * 
IMPEDED PROCESS PCB 
HEAD INDEX 



TAIL INDEX 



I1AXII1U1 OF IN USE 
CURRENT IN USE 



TOTAL REQUESTS 



UNUSED 



INDEX OF 5 



INDEX OF 1 



THEBO 
TTAIL 
TUSE 

TOVRFL 
TRQSTS 
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108 ICont.) 



Indeterninate 



ENTRY 1 
(IN USE) 
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I/O Queue Eienent (IDC) 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|„|--|--|--|-_|-_|„|-|-|~|~|--|~j~|~|-- 
I REQUEST DEPENDENT FLRGS 



31 

I — 
4|S | 



109 POINTER 

QLDEVH 
MISCELLANEOUS 
DfiTR SECflENT DST NUMBER 



BDDRESS 

UNIT | FUNCTION 

COUNT/XLOWCONTROL RETURNS 
PI 
P2 



10I///////////////////////I QUALIFIER I STATUS 

I 

11 1 FR ! PCBN 



QFLAG 
SLINK 
QLDEV 
QMISC 

QDSTN StUon! 4(0:1) 
Stackflag If set 
QRDDR is DB rel. 

QADDR 

QFUNC 

QUBCT 

QPRR1 

QPAR2 

QSTfiT 

QPCBN 



QFLRfj • 
Bit 0 



Bit 2 
Bit 3 



Bit 4 
Bit 5 



Request dependent Flags 

Request has been aborted externally. 



.ABORT 
.SPECIAL 



.MSG 
.SBUF 



.IOUAKE 
.BLOCKED 



Special handling is to be applied to this 
request. For disc, indicates a nemry 
nanagenent request. 

Diagnostic request (not used). 

Systen Buffer. Target is a systen buffer 
whose index is relative to the start of 
the SBUF table. 

Uake caller on conpletion of request. 

Blocked I/O. Caller is uaited in ATTACHIO until 
request is conpleted. 

Request has been conpleted and caller woken if 
he had specified. 
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I/O Queue Eienent fCont.) 



I/O Systen Status Returns 



Bit 7 . DRTRFRZN Data segnent has been nade present and is 
frozen. 

Bit 8 .MAMERRORD MAM error on data segnent nake present. 

Bit 9 . PREQ This request has been started but uas preenpted 

by a UAH request. 

Bit 10 . SFRIL Start SIO failure in GIP. 

Bit 11 .PFfllL The I/O has been aborted because of a power-fail. 

Bits12-13 .PREEMPT Preenptive type code: 1-soft, 2-hard. 

Bit 15 .I1SGD0NE A nessage request reply has conpleted. 
QLINK - Table relative index of next IOQ eienent. Points to first 

word of eienent. 
QLDEV - Logical Device Hunber 
QMISC - Device dependent. 

QDSTN - If SYSBUFRs is clear then this is the DST number of the target 
data segnent. If bit 0 is set then buffer address is a D8 offset 
value instead of segnent relative offset (inplenented for 
NOURIT 10 and N08UFF). 

QRDDR - Offset in data segnent or sys buff table to target data buffer. 

QFUNC. FUNC - Function code and qualifiers as specified by driver. 

QUBCT - On initiation specifies the uord count if positive or byte 

count if negative. At conpletion of the request this location 
contains the actual transnission count in the sane units as the 
call. Certain control requests return data through this 
location. 

QPAR1 - Paraneter one, defined by driver 
UPAR2 - Paraneter two, defined by driver 

QMISC - fliscellaneous request dependent storage available to driver. 
QPCBN - PCB Nunber of process which nade this request. Zero if 

not associated uith any process and IOQ is to be returned 

by the systen. 

.QUALIFIER - ft code which further defies or qualifies the 

general status. Defined by driver. 
.STATUS - General Status. Indicates current and result state of 
the request according to the following codes. 

0 - not started or awaiting conpletion. 

1 - successful conpletion. 

2 - end of file detected. 

3 - unusual condition. 

4 - irrecoverable error. 

Uord 11 bit 0- Queue eienent is on free list. 
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1 - UAITING FOR COMPLETION 

2 - DOING ERROR RECOVERY 

3 - NOT READY URIT 

4 - NO URITE RING URIT 

5 - NEU PAPER TRPE UNIT 



0 - NORMAL 

1 - READ TERMINATED UITH SPECIAL CHRRACTER 

2 - TAPE RETRY FOR SUCCESS REQUIRED 

3 - LOU TAPE OR END OF TAPE AFTER URITE 



2 - END OF FILE 



1 - PHYSICAL END OF FILE 

2 - DATA 

3 - END OF DflTR 

4 - HELLO 

5 - BYE 
fi - 1QR 

7 - END OF JOB 



3 - UNUSUAL CONDITION 



10 
20 
30 
40 
50 



12 
22 
32 
42 
52 
62 
72 



1 




TERMINAL PARITY ERROR 


13 


2 




TERMINAL READ TIRED OUT 


23 


3 




I/O ABORTED EXTERNALLY 


33 


4 




DATA LOST 


43 


5 




DATR SET NOT READY OR DISCONNECT 


53 






OR UNIT HOT OH LINE 




6 




ABORTED BECAUSE OF POUER FAIL 


63 


7 




BOT AND BSR, 8SF REQUEST 


73 


10 




TAPE RUNHUAY 


103 


11 




EOT AND URITE REQUEST 


113 


12 




NO URITE RING AFTER REQUEST TO OPERATOR 


123 


13 




END OF TAPE (PAPER TAPE LOU) 


133 


14 




PLOTTER LIMIT SUITCH REACHED 


143 


15 




ENABLE SUBSYSTEM BREAK AND NO CONTROL Y PIN 


153 


16 




READ TIME RETURNED OVERFLOU 


163 


17 




BREAK STOPPED READ 


173 


20 




URITE AND NO CARD IN UAIT STATION 


203 


21 




DEVICE POUERED ON - OPERATING EHVIROHMEHT LOST 


213 


27 




VFC HAS SEEN RESET 


273 
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I/O Systen Status Returns (Cent, ) 



A - IRRECOVERABLE ERROR 

0 - INVALID REQUEST 4 

1 - TRANSMISSION ERROR 14 

2 - I/O Tint OUT 24 

3 - TIIIIMC ERROR 34 

4 - SIO FBI LURE 44 

5 - UNIT FBI LURE 54 

6 - INVALID DISC BOORESS 64 

7 - TAPE PARITY ERROR 74 

11 - PAPER TBPE TAPE ERROR 114 

12 - SYSTEM ERROR 124 

13 - INVALID SBUF INDEX 134 

14 - CHANNEL FAILURE, TIMEOUT OR NO RESPONSE FROM 144 

CONTROLLER 

15 - UNINITIALIZED tIEDIB (UNUS) 164 

16 - NO SPARE BLOCKS AVAILABLE 164 

17 - DELETED RECORD DETECTED ON IBM FLOPPY DISC 174 

20 - LABELED DEVICE UNAVAILABLE AFTER REELSUITCH 204 

21 - PARITY ERROR DETECTED ON PHI COMMAND (EPOC) 214 



5 - ERROR IN DATS CONTROL INFORMATION 



0 - INVALID ITEn NUMBER 

1 - INVALID ACCESS FOR ITEM 

2 - FAILURE IN FOPEN OR FREAD 

3 - PARITY CHANGE IN 8 BIT MODE 

4 - INVALID INFO. FILE FORMAT 

5 - CHECKSUM ERROR IN INFO FILE 

6 - PASSED VALUE LESS THAN MIN. 

7 - PASSEO VALUE GREATER THAN MAX. 

0 - PASSED VALUE IS UNSUPPORTED 

1 - COUNT LESS THAN REQUIRED TO 

RETURN ALL INFO. 

2 - COUNT GREATER THAN AVAILABLE 

TO STORE INFO. 

3 - PASSED VALUES NOT IN ASCENDING 135 

ORDER 

PASSED CHARACTER HAS OTHER 145 
DEFINED FUNCTION 



14 



5 
15 
25 
35 
45 
65 
65 
75 
105 
115 

125 



VALID ACCESS 
FS ERROR NUMBER 



MIN. VALUE BLLOUED 
MAX. VALUE ALLOUCD 

MIN. SPACE NEEDED 

MBX.SPACE AVAIL 

OFFSET OF ELEMENT 

OTHER FUNCTION 
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Bit 6 COMPLETED - 
Bit 7 DATAFRZN ■ 



Bit 8 HAflERRORD 



Bit 9 PREO 
Bit 10 SFAIL 



Bit 11 PFAIL 



until the request is conpleted. Inplies IOUAKE. 
The request has been cortpieted and the caller 
auakened if he had requested (uith IOUBKE). 
Set by the nenory nanagenent routines (flflM) uhen a 
MAKEPRESENT request is successfully conpleted and 
indicates the data segrtent is frozen in nenory. 
An error has occurred while HAM was trying to 
nake the target data segnent present and freeze 
it in nenory. 
(Hot used) 

Delayed failure of SIO instruction. If a call to 
START' HPIB resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed uhen the request uas selected 
for execution. 

The request uas aborted because of a systen pouer 
failure. 



QRISC - Driver request dependent flags and counters. Used nostly for 
error retries. 



RETRY 
BACK 



GAP 

BODEOF 

TOUTCNTR 
FSCNTR 
BSCNTR 
RTCNTR 



- Indicates an error retry is in progress. 

■ Backspace record processing for an error retry is in 
progress. 

■ Forward space record processing for an error retry is 
in progress. 

■ Gap processing for an error retry is in progress. 

■ Backspace record due to a data EOF processing is in 
progress. 

• GIC tined-out counter. 
' Forward space record counter. 
Backspace record counter. 

■ Error retry counter. 



QSTAT - PCB nunber and request conpletion status. 

PCBN - The Process Control Block (PCB) nunber of the process 
which nade this request. If zero, the request is not 
associated uith any process and the IOQ element is to 
be returned by the systen uhen the request has conpleted. 

STATUS - General status indicating the final state of the request. 
The following codes are used: 

0 - Not started or auditing conpletion. 

1 - Successful conpletion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

QUALIFIER - A code uhich further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 
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I/O Queue Elenent for 7976R Magnetic Tape 



0 1 2 3 4 5 6 7 ! 9 10 11 12 13 14 15 

4--4~4— 4—4— 4— 4—4— 4— 4__4„»__4.. ,__,__,— , 

01 Request dependent flags (see belou) | 
+—+—+--+— +—4— t— +—+—+—+—+—+—+—+—♦— ♦ 

1 1 SYSDB relative pointer to next IOQ elenent. | 
I Points to first word of elenent. I 
* ♦ 4 

21 logical device nunber | 
4— 4--4--f--4— 4 4 — + 4 4 4 

31 R| Bl F| GISOI TOUTI FSCNTR | BSCNTR I RTCNTR I 

4— *--4— 4— 4— 4 4 4 4 4 

4| S| If QFlflC. (3:1) is clear then this is the | 
i I DST nunber of the target data segnent. If I 
I I S is set, QADOR is DB relative. I 

4—4 1 

5| Offset in the data segnent or systen buffer I 
I table to the target data buffer. j 

4 4 f 

6| | Function code for | 
I this request. (See I 
t I next section.) j 
4 4 4 

7| On initiation, specifies the word count (*)) I 
I or byte count (<0). At conpletion of the i 
I request this location contains the actual 
I transnission count in the sane units (bytes I 
I or uords) as in the request. \ 
* 1 

X10| Paraneter 1. Used only for reads. Contains I 
I the EOF specification in bits (13:3). I 
♦ -4 

111 1 Paraneter 2. Used only for urites. If bit I 
I (13:1) is set, uriting past EOT is alloued. I 



MNEMONIC 
QFLAG 
SLINK 

QLDEV 
QMISC 
QDSTN 

QADDR 
QFUNC 

OUBCT 



QPAR1 
QPAR2 
QSTAT 



2131 
I- 



PCB NUMBER 



QFLAG - Request dependent flags 

Bit 0 RBORT - Abort this request and return an error indication to the 
caller. 

Bit 1 SPECIAL - Apply special handling to this request. (Not used) 
Bit 2 DIRC - This is a request fron the diagnostic subsysten. 
(Not used) 

Bit 3 SYSBUFF - Target is an index relative to the SBUF Table of 
the data buffer. 
Bit 4 IOUAKE - Uake caller on conpletion of request. 
Bit 5 BLOCKED - Blocked I/O. The caller is uaited in ATTACHIO 
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I/O Queue Elenent (IOQ) for CIPE8 
0 1 2 3 4 5 6 7 8 3 10 11 12 13 14 15 MNEMONIC 

4—4—4—4 — 4— 4— 4— 4 — 4— 4— 4 — 4— 4 — 4 — 4 — 4- -4 

Ol Request dependent flags (see belou) 



II IOQ table index to the next IOQ elenent. 
I Points to first uord of elenent. 



Logical device nunber 



4| I If QFLAG. (3:1) is clear then this is the 
I S| DST nunber of the target data segnent. If 
I | S is set, QADDR is DB relative. 



51 Offset in the data segnent or systen buffer 
j table to the target data buffer. 



I Function code for 
I this request. (See 
I next section.) 



7 1 On initiation, specifies the word count (>0) 

i or byte count (<0). At conpletion of the 

I request this location contains the actual 

I transnission count in the sane units (bytes 

I or uords) as in the request. 



1101 Paraneter 1. 



1111 Paraneter 2. 

4 

Z12| 

4 

1131 



I QUALIFIER IRSTBTUS 
PCBN 



QFLAG 
QLIHK 

QLDEV 
QMISC 
QDSTN 

QADDR 
QFUNC 

QUBCT 



QP0R1 
QPAR2 
QSTAT 
QPCB 



QFLAG - Request dependent flags 

Bit 0 RBORT - Abort this request and return an error indication 
to the caller. 

Bit 1 SPECIHL - Apply special handling to this request. (Not used) 
Bit 2 DIBG - This is a request fron the diagnostic subsysten. 
Bit 3 SYSBUFF - Target is an index relative to the SBUF Table of 

the data buffer. 
Bit 4 IOUAKE - Uake caller on conpletion of request. 
Bit 5 BLOCKED - Blocked I/O. The caller is uaited in ATTACHIO 

until the request is conpleted. Inplies IOUAKE. 
Bit S COMPLETED - The request has been conpieteo and the caller 

awakened if he had requested (uith IOUBKE ) . 
Bit 7 DATAFRZN - Set by the nenory nanagenent routines (MAM) uhen a 
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Bit 8 HAtlERRORD 



Bit 9 PREO 
Bit 10 SFfllL 



HRKEPRESENT request is successfully completed and 
indicates the data segnent is frozen in nenory. 
Rn error has occurred while flflfl was trying to 
nake the target data segnent present and freeze 
it in nenory. 
(Not used) 

Delayed failure of SIO instruction. If a call to 
STflRTIO resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed uhen the request uas selected 
for execution. 
• The request was aborted because of a systen power 
failure. 



QSTHT - PCB nunber and request conpletion status. 

PCBN - The Process Control Block (PCB) nunber of the process 
uhich nade this request. If zero, the request is not 
associated with any process and the IOQ elenent is to 
be returned by the systen uhen the request has conpleted. 

RSTflTUS - General status indicating the final state of the request. 
The following codes are used: 

0 - Not started or auaiting conpletion. 

1 - Successful conpletion. 
Z - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

QUALIFIER - fl code uhich further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 

HP-IB CIPER Physical Driver Request Codes 

OPERATION FUNCTION PfiRfiNfTERS 



HERD 


0 


None 


URITE 


1 


None 


FILE OPEN 


2 


None 


FILE CLOSE 


3 


None 


DEVICE CLOSE 


4 


None 


CIPER INIT 


84 


None 



CIPER Driver Return Status Codes 
Ceneral Status (13:3) Qualifying Status (8:5) 
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Z11 1 Paratieter 2. Space Hode Flags. CSee next 
I section for details. ) 



Z12I///////////////////////I QUALIFIER 

+ + 

%13| PCB NUflBER 



QSTflT 
QPCBN 



QFLflG - Request dependent flags 

Bit 0 ABORT - Rbort this request and return an error indication 
to the caller. 

Bit 1 SPECIBL - Rpply special handling to this request. (Not used) 
Bit 2 DIflG - This is a request fron the diagnostic subsystem 
(Not used) 

Bit 3 SYSBUFF - Target is an index relative to the SBUF Table of 

the data buffer. 
Sit 4 IOURKE - Uake caller on conpletion of request. 
Bit 5 BLOCKED - Blocked I/O. The caller is uaited in ATTflCHIQ 

until the request is conpleted. Inplies IOUfiKE. 
Bit 6 C0I1PLETED - The request has been conpleted and the caller 

awakened if he had requested (uith IOUflKE). 



0 - Pending 



1 - Successful 



1 - Waiting For Conpletion 
3 - Not Ready wait 



(Not Used) 



3E30 



' Unusual Condition 



■ Irrecoverable Error 



3 - 


Request Rborted 


Z33 


6 - 


Pouerfail Rbort 


Z63 


121 - 


Device Pcuered Up 


Z213 


0 - 


Invalid Request 


Z4 


1 - 


Transfer Error 


Z14 


2 - 


I/O Titled Out Before Conplete 


Z24 


4 - 


SIO Failure 


Z44 


5 - 


Unit Failure 


Z54 


Z12 - 


Systen Error 


Z124 


114 - 


Channel Failure 


Z144 


Z21 - 


Parity Error 


Z214 



2608 Line Printer I/O Queue Elenent (HP-IB Svstens) 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

^ — 4 — + — + — + --+ — + — + — + — * — + — + — + — t — * — + — + 

0| Request dependent flags (see belou) I 

+ — 4— +--+ — + — + —+—+— + — t—t—4 — + —+—+--♦— + 

1 | SVSDB relative pointer to next IOQ elenent. i 
| Points to first uord of element. I 
+ 1 + 

2 | Logical device nunber | 
+--+„+--+ + + + + 

3 | PP I PE I nC I TOUTCNTR | | UHITCODE I 
+--+--*--+ + * + 

4| S| If QF LAG. (3:1) is clear then this is the I 
| | DST nunber of the target data segnent. If I 
! | S is set, QflDDR is DB relative. I 
-+ 

5 1 Offset in the data segnent or systen buffer I 
I table to the target data buffer. I 



I 



I Function code for 
I this request. (See 
j next section.) 



nNEtioNic 

OF LAO 
QLINK 

QLDEV 

onisc 

QDSTH 

QADDR 
OFUNC 



On initiation, specifies the uord count (>0) I QUBCT 

or byte count (<0). Rt conpletion of the ! 

request this location contains the actual I 

transmission count in the sane units (bytes I 

or words) as in the request. ! 



Z10| Paraneter 1. Vertical Fornat specification. 
I (See next section for detail.) 
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Bit 7 DATAFR2N 



Bit S flfWERRORD 



Bit 9 PREQ 
Bit 10 SFfllL 



■ Set by the nenory management routines (flfin) uhen a 
tlAKEPRESENT request is successfully conpleted and 
indicates the data segnent is frozen in nenory. 

• An error has occurred uhile flflfl uas trying to 
nake the target data segnent present and freeze 
it in nenory. 

- (Not used) 

■ Delayed failure of SIO instruction. If a call to 
STflRTIO resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed uhen the request uas selected 
for execution. 

- The request uas aborted because of a systen power 
failure. 



GflISC - Driver request dependent flags and counters. 

PRE' TO' POST - Pre to post spacing change flag. 
PEJECT - Last operation uas a page eject. 
flASTERCLR - Master clear done to clear pouerfail bit in status. 

Haster clear needs to be done fron not ready condition. 
TOUTCNTR - Channel tine-out retry counter. 
UfllTCCDE - Indicates type of wait: 

0 - new request 

1 - conpletion uait 

2 - not ready uait 



QSTflT - PCB nunber and request conpletion status. 

PCBN - The Process Control Block (PCB) nunber of the process 
which nade this request. If zero, the request is not 
associated uith any process and the IOQ elenent is to 
be returned by the systen uhen the request has conpleted. 

STATUS - General status indicating the final state of the request. 
The follouing codes are used: 

0 - Not started or auaiting conpletion. 

1 - Successful conpletion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

QUALIFIER - A code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes. ) 
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Operation 
UMTE 



Function 
1 



2608 Line Printer Request Codes 



P1 - Vertical Format Specification 
1 - use 1st data char as fomat spec 

253 - "+", print met suppress spacing 

255 - print and triple space 

Z60 - "0", print and double space 

X61 - "1", print and top of form 

Z200-Z277, print and space N-ZZOO lines 
X300-Z377, print uith channel N-X277 

Nil others, print and single space. 



P2 • 



FILE OPEN. I 

FILE CLOSE 3 

DEVICE CLOSE 4 

READ STATUS 3.17 



VFC SET 



Space Rode Flags 
£15:1) - Prespace flag 

if set, print then fill buffer 
if clear, fill buffer then print 
(14:1) - No page stepover flag 
if set, single and double space 

without stepover (66 lines/page) 
if clear, single and double space 
uith stepover (60 lines/page) 

Page eject if not at top of forn 

Page eject if not at top of forn 

Page eject if not at top of forn 

Read I/O status 
Count - buffer must be at least 2 bytes 

Load VFC Rfin 
Count - fom length in words 

(0 loads Rfiil forn internal ROn) 
P1 - 6 for 6 LPI or 8 for 8 LPI 

any other value defaults to 6 LPI 

Sets logical column definition 
PI - 0 to 15, any other value defaults to IS 
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until the request is completed. Implies IWJflKE. 
Bit 6 COMPLETED - The request has been conpleted and the caller 
awakened if he had requested (with IOUfiKE). 



Sit 7 DBTRFRZH 



Bit 8 HflHERRORD - 



Bit 5 PRESS 
Bit 10 SFPJL 



Set by the memory nanagenent routines (IWn) when a 
RRKEPRESENT request is successfully conpleted and 
indicates the data segment is frozen in nenory. 
Rn error has occurred uhile HAD uas trying to 
nake the target data segnent present and freeze 
it in nenory. 
(Not used) 

Delayed failure of SIO instruction. If a call to 
START 10 resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed when the request was selected 
for execution. 

The request uas aborted because of a system power 
failure. 



QHISC - Driver request dependent flags and counters for 2631 . 

PRE'TQ'PQST - Pre to post spacing change flag. 

PEJECT - Last operation uas a page eject. 

TOUTCKTR - Channel tine-out retry counter. 

POUERFfllL - Power fail flag indicates power fail occurred. 

liRITCQDE - Indicates type of wait: 

0 - new request 

1 - completion wait 

2 - not ready wait 



I / D 



2619R I 2631 Line Printer IDQ Element [HP-IB System) 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



Request dependent flags (see belou) 



1| SYSDB relative pointer to next IOQ eienent. 
I Points to first ucnl of eienent. 



21 Logical device mincer 

+ — + — + — + + ♦ + 

3|PPIPE|PFlT0UTCNTR| | (WITCQOE 



4| S( If QFLAG.(3:1) is clear then this is the 
I I DST number of the target data segnent. If 
! i S is set, QRODR is DB relative. 



51 Offset in the data segnent or systen buffer 
I table to the target data buffer. 



I 



Function code for 
this request. (See 
next section. ) 



7| On initiation, specifies the word count (>0) 

I or byte count (<Q). fit completion of the 

I request this location contains the actual 

I transmission count in the sane units (bytes 

I or words) as in the request. 



210! Parameter 1. Vertical Format specification. 
I (See next section for detail. ) 



Parameter 2. Space node Flags. (See next 
I section for details. ) 



Z12I///////////////////////I QUALIFIER | STRTUS 

+ 4 i 

X13| 



PCB NUMBER 



HNEHONIC 
QFLRG 
fi LINK 

QLDEV 
QRISC 
QDSTN 

OADDR 
Q.FUNC 

QUBCT 



GPAR1 

0PAR2 

QSTflT 
0PC8N 



QFLflG - Request dependent flags 



Bit 0 


ABORT 


Bit 1 


SPECIBL 


Bit 2 


DIDS 


Bit 3 


SYS8UFF 


Bit 4 


IOUAKE 


Bit 5 


BLOCKED 



• Abort this request and return an error indication 
to the caller. 

Apply special handling to thii request. (Hot used) 
This is a request fron the diagnostic subsystem. 
(Not used) 

Target is an index relative to the SBUF Table of 
the data buffer. 

Uake caller on conpletion of request. 

Blocked I/O. The caller is uaited in BTTfCHIO 

G.00.00 
13- 70 



I / 0 

Fomat for Z619H 
0 12 3 4 
|PP|P£|PF|TO|BF| 



12 15 
I UMTCOOE | 



TOUT - Channel tined out flag 

BUF'FILL - Buffer fill operation in progress 

QSTflT - PCB nurtber and request conpletion status. 

PCBN - The Process Control Block (PCB) nunber of the process 
uhich nade this request. If zero, the request is not 
associated uith any process and the 100 eienent is to 
be returned by the systen uhen the request has conpleted. 

STATUS - General status indicating the final state of the request. 
The Following codes are used: 

0 - Not started or awaiting conpletion. 

1 - Successful conpletion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

JUBUFIER - P code uhich further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 
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2619 Line Printer Request Codes 



Operation Function 
URITE 1 



FILE OPEN 2 

FILE CLOSE 3 

DEVICE CLOSE 4 

READ STATUS Z1? 



IDENTIFY 



*SELF TEST: 
INITIATE 



Z110 

Z111 
2112 



*L0OPBRCK TEST: 
URT DHTR Z113 
READ DflTH Z114 



P1 - Vertical Fornat Specification 
1 - Use 1st data char as fornat 
specification. 

Z53 - print and suppress spacing 

Z55 - print and triple space 

Z60 - "0", print and double space 

Z61 - "1", print and top of forn 

Z200-Z277, print and space N-X200 lines 
Z300-X312, print with channel N-Z277 

Z320 - Fill Line Printer Buffer Only 

All others, print and single space. 

P2 - Space node Flags 

(15:1) - Prespace flag 

if set, print then fill buffer 
if clear, fill buffer then print 
(14:1) - Ho page stepover flag 
if set, single and double space 

without stepover (66 lines/page) 
if clear, single and double space 
uith stepover (60 lines/page) 

Page eject if not at top of forn 

Page eject if not at top of forn 

Page eject if not at top of forn 

Read I/O status 
Count - buffer size 

Return ID value in Bank & Buffaddr 



Subtest nunber to execute in Bank and Buffaddr 

(subtest number ranges fron 0 to 7) 
Subtest result returned in Bank & Buffaddr 



Data to LP in Bank & Buffaddr [PING] 

Data Fron LP read into Bank & Buffaddr [PONG] 

Count - Buffer Size (256 bytes nax) 
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2631 Line Printer Request Codes (HP-IB) 

Operation Function Paraneter 

URITE 1 



FILE OPEN 2 

FILE CLOSE 3 

DEVICE CLOSE 4 

RERD STATUS Z17 



VFC SET 



Z100 



P1 - Vertical Fornat Specification 
1 - Use 1st data char as fornat 
specification. 

Z53 - "+", print and suppress spacing 

Z55 - print and triple space 

260 - "0", print and double space 

Z61 - "1", print and top of fom 

Z200-X277, print and space N-Z200 lines 
Z30O-Z3O7, print with channel H-Z277 

Z320 - Fill Line Printer Buffer Only 

All others, print and single space. 

P2 - Space flode Flags 

(15:1) - Prespace flag 

if set, print then fill buffer 
if clear, fill buffer then print 
(14:1) - No page stepover flag 
if set, single and double space 

without stepover (66 lines/page) 
if clear, single and double space 
uith stepover (60 lines/page) 

Page eject if not at top of forn 

Page eject if not at top of forn 

Page eject if not at top of forn 

Read I/O status 
Count - 1 byte nininun required 

LOADS VFC RAH 

P1 - 1 - 1 LPI (lines per inch) 

2 - 2 LPI 

3 - 3 LPI 

4 - 4 LPI 

5 - 5 LPI 

6 - 6 LPI 
8 - 8 LPI 

12 - 12 LPI 

Any other value defaults to 6 LPI. 
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I/G Queue Elenent For HP-IB Card Reader 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
+--+-- +—+--+— +--+-- +—+--+-- +--+--+—- +—+—+— + 
Oj Request dependent flags (see belou) | 



1| SYSDB relative pointer to next IOQ elenent. 
I Points to first word of elenent. 



Logical device nunber 
Auxiliary buffer flag. 



Sj If QFLAG.(3:1) is clear then this is the 
| DST nunber of the target data segnent. If 
I S is set, QADDR is OB relative. 



Offset in the data segnent or systen buffer 
table to the target data buffer. 



I 



Function code for 
this request. (Set 
next section. ) 



On initiation, specifies the uord count (>0) 
or byte count (<0). Rt conpletion of the 
request this iocation contains the actual 
transnission count in the sane units (bytes 
or words) as in the request. 



210 | Paraneter 1. Contains the EOF specification 



Z11 1 



Paraneter 2. Contains the data node 
specification in bits (11:2). (See belou card 
reader request codes for detail infomation) 



Z12I///////////////////////I QUALIFIER | STATUS 



X13I 



PCB NUtlBER 



UNEflONIC 
QFLflG 
BLINK 

QLDEV 

anise 

QDSTH 

QADDR 
QFUNC 

QUSCT 



QPRR1 
QPRR2 



QSTAT 
QPCBN 
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Bit 6 COMPLETED • 
Bit 7 DATAFRZH • 



Bit 8 (1ARERR0RD 



Sit 9 PREQ 
Bit 10 SFAIL 



Bit 11 PFAIL 



The request has been conpleted and the caller 
awakened if he had requested (uith IOUflKE). 
Set by the nenory nanagenent routines (flfiTl) when a 
HRKEPRESENT request is successfully conpleted and 
indicates the data segnent is frozen in nenory. 
An error has occurred uhile UAH was trying to 
nake the target data segnent present and freeze 
it in nenory. 
(Not used) 

Delayed failure of SIO instruction. If a call to 
STARTIO resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed uhen the request uas selected 
for execution. 

The request uas aborted because of a systen power 
failure. 



QfllSC - Ruxiliary buffer flag used to indicated a read into the 
driver's buffer and not the user's buffer. 



QSTRT - PCB nunber and request conpletion status. 

PCBN - The Process Control Block (PCB) nunber of the process 
which nade this request. If zero, the request is not 
associated with any process and the IDQ elenent is to 
be returned by the systen when the request has conpleted. 

STATUS - General status indicating the final state of the request. 
The following codes are used: 

0 - Not started or awaiting conpletion. 

1 - Successful conpletion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable) condition detected. 

4 - Irrecoverable error has occurred. 

QUALIFIER - R code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 



QFLRG - Request dependent flags 



Bit 0 


ABORT 


Bit 1 


SPECIAL - 


Bit 2 


OIBG 


Bit 3 


SYSBUFF - 


Bit 4 


MAKE 


Bit 5 


BLOCKED - 



Abort this request and return an error indication 
to the caller. 

Apply special handling to this request. (Not used) 
This is a request fron the diagnostic subsystem 
Target is an index relative to the SBUF Table of 
the data buffer. 

wake caller on conpletion of request. 

Blocked I/O. The caller is waited in ATTACHIO 

until the request is conpleted. Inplies IOUflKE. 
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CS 80 Disc Reouest Queue Elenent (108) 



0 1 Z 3 4 5 6 7 8 9 10 11 12 13 14 15 

♦ — ~- — 

0| Request dependent flags (see belou) 
1 | Request urgency class 
2 1 Logical device nunber 

3|CHflHF|RS|0P|II1|SR|RTRAN|LF|SP| I UMTCOOE 
4t SI OST (If process disc I/O) 

DST (If segnent transfer) [S=StachJ 



XI 2 
Z13 
114 
115 
116 
11? 
120 



Offset in the data seg (If process disc I/O) 
Address in Sank (If segnent transfer) 



Unit H 



I function code for 
j this request. 



On initiation, specifies the word count (>0) 
or byte count (<0). (ft conpletion of the 
request this location contains the actual 
trahsniasion count in the sane units (bytes 
or words) as in the request. 



PI - Paranetcr 1 (Usually High Order of 
Current Logical Disc Address [CLDA1]) 



P2 - Paraneter 2 (Usually Lom Order of 
Current Logical Disc Address [CL0R2]) 



////////////////////// I QUALIFIER | STATUS 
PCB 

Sysbase relative indx of previous req in queue 
Sysbase relative indx of next req in queue 
Segidentifier (If segnent transfer 
Displacenent of read or Hit fron seg base ((111) 



S I//////////////////////////////////////////// 

U I//////////////////////////////////////////// 

A I//////////////////////////////////////////// 

P I//////////////////////////////////////////// 



unehokic 

OF LAC- 
QURGCLASS 
QLDEV 

onisc 

ODSCTN 

OfiOOR 

QFUNC 
QUBCT 



0PAR1 
0PAR2 
QSTAT 

OPREVREOP 
OHEKTSEOP 
SSEOIDENT 
OSEGOISP 
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QFLA& - Request dependent flags 



Bit 0 ABORT 

Bit 1 nnREO 

Bit 2 OIAO 

Bit 3 SBUF 

Bit 4 IOUAKE 

Bit 5 BLOCKED - 

Bit 6 COMPLETED - 

Bit 7 DATAFRZN - 

Bit 8 HflftERRORD - 



Bit 9 PREOUEUED 
Bit 10 SFAIL 



Bit 


11 


PFAIL 


Bit 


12 


CURREO - 


Bit 


13 


DISABLED - 


Bit 


14 


DISRTMPT - 


Bit 


15 


HSCO0NE - 



Request has been aborted externally. 

Request is for a segnent transfer. 

This Is a request fron the diagnostic subsystem 

Target is an index relative to the SBUF Table of 

the data buffer. 

Uake caller on completion of request. 
Slocked I/O. The caller is Mailed in RTTRCHIO 
until the request is completed. Inplies IOUfiKE. 
The request has been cowpieted and the caller 
awakened if he had requested (with IOUfiKE). 
Data segnent has been present and is frozen, 
fln error has occurred while UAH Has trying to 
nake the target data segnent present and freeze 
it in nenory. 

Request is queued into disc's request queue 
Delayed Failure of SIO instruction. If a call 
to STflRTIQ resulted in the request being added 
to the channel queue, this bit indicates that 
the SIO instruction Failed uhen the request Mas 
selected for execution. 
The request uas aborted because of a systen 
pouer failure. 

Request is device's current request. 

Request is disabled. 

fittenpt to disable this request. 

fl nessage request reply has completed. 



QLDEV. QIDEVN - Logical Device Nunber 

CX1ISC - Driver request dependent flags and counters. 

CHfttTERR'FLG - Channel error retry flag. 
RSTRT' FfilL 1 FLG - Request status failed flag. 



OPER'REQ'FLG 
III'FRULT'FLG 
STfiTRTRY'FLG 
RTRfiNS'FLG 
LOAD" FLG 
SYS'PFRIL'FLG 

tlfllTCODE 



Operator requested release flag. 
Internal naintenance fault flag. 

■ Status error single retry flag. 

■ Retransnit required flag. 
- Media load flag. 

■ Systen oouerfail flag. 

■ Indicates type of wait: 

0 - new request 

1 - conpletion wait 

2 - not ready uait 

3 - release/release deny uait 

4 - 100 defer uait 

5 - DSCT read uait 

6 - DSCT write uait 

7 - synchronization uait 
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QDSTN - If systen buffer is clear then this is the DST 
nunber of the target data segnent. If bit 0 is 
set then buffer address is a OB offset value 
instead of segnent relative offset (inplenented 
for NOURIT I/O and NOBUFF). 

QflDOR - Offset in data segnent or systen buffer table to 
target data buffer. 

QFUNC - Function code and qualifiers «s specified by 
driver. 

QSTRT - PCB nunber and request conpletion status. 

PCBN - The Process Control Block (PCB) nunber of the process 
uhich rude this request. If zero, the request is not 
associated uith any process and the IQQ elenent is to 
be returned by the systen uhen the request has conpleted. 

STATUS - General status indicating the final state of the request. 

0 - Not started or awaiting conpletion. 

1 - Successful conpletion. 

2 - End-of-fila detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

QUALIFIER - R code uhich further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 



r ?,, $Q -,?. n tegrated Cartridge Tape Request 



0 1 2 3 4 5 6 7 i 9 10 11 12 13 14 15 
+ — — . 

0| Request dependent flags (see belou) 
+ — _ — 

1| Request urgency class 
+ ♦ 

2 1 Logical device nunber 

4 +-_+__+ — 4 4 

3|CHnNF|RS|0P|H1| RETRY |LF|SP| | UfllTCODE 

+ -—-+--+--+—♦ _-4_-+__+ 4 

41 SI DST (If process disc I/O) 

I DST (If segnent transfer) [S-Stack] 

+--* — 

Sj Offset in the data seg (If process disc I/O) 

I Address in Bank (If segnent transfer) 



Unit tt 



Function code for 
this request. 



7 1 On initiation, specifies the word count (>0) 

I or byte count (<0). Rt conpletion of the 

j request this location contains the actual 

I transnission count in the sane units (bytes 

I or words) as in the request. 



MNEMONIC 
OF LAG 
QURGCLASS 
QLDEV 
QflISC 
QDSCTN 

QADDR 

QFUNC 
QUBCT 



Z10I P1 - Paraneter 1 (Usually High Order of | QPRR1 
I Current Logical Disc Address [CLDR1 ]) \ 
+ 1 

Z11I P2 - Paraneter 2 (Usually Lou Order of I QPRR2 

! Current Logical Disc Address [CLDR2]) j 
+ + + + 

Z12I PC8N | QUALIFIER I STRTUS I QSTAT 

4 + 4 + 

2131 Sysbase relative indx of previous req in queue | QPREVREQP 

4 4 

X14( Sysbase relative indx of next req in queue | QNEXTREQP 

+-- + 

1151 Segidentifier (If segnent transfer | QSEGIDENT 

+ - + 

XI 6 1 Displacenent of read or urt fron seg base (flf1)| QSE&OISP 

xi7is i liiiiuifitHtfitiUiiHitiiiitifiitfiuim i 

in I////////////////////////////////////////////I 

i r i ///////// iiimiiHimmuuiiiiiuiiiHit i 
ip \iimuti!tH(flttnilMittittfiUftHt(iiit\ 

QFLflG - Request dependent flags 
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Bit 


0 


ABORT 


Bit 


1 


rtHREQ 


Bit 


2 


DIBC- 


Bit 


3 


SBUF 


Bit 


1 


IOUHKE 


Bit 


5 


BLOCKED - 


Bit 


6 


COMPLETED - 


Bit 


7 


DBTHFRZN - 


Bit 


S 


nnnERROao - 


Bit 


9 


PREQUEUED - 


Bit 


10 


SFBIL 



Sit 11 PFRIL 

Bit 12 CURREQ 
Bit 13 DISABLED 
Bit 14 DISATHPT 
Bit 15 nSGDOHE 



Request has been aborted externally. 

Request is for a segnent transfer. 

This is a request fron the diagnostic subsystem 

Target is an index relative to the SBUF Table of 

the data buffer. 

Uake caller on conpletion of request. 
Blocked I/O. The caller is waited in flTTHCHID 
until the request is conpleted. Irtplies IOUflKE. 
The request has been conpleted and the caller 
auakened if he had requested (with IOUAKE). 
Data segnent has been present and is frozen. 
An error has occurred uhile HRPf uas trying to 
Make the target data segnent present and freeze 
it in nenory. 

Request is queued into disc's request queue 
Delayed failure of SIO instruction. If a call 
to STRRTIO resulted in the request being added 
to the channel queue, this bit indicates that 
the SIO instruction failed uhen the request uas 
selected for execution. 
The request uas aborted because of a systeti 
power failure. 

Request is device's current request. 

Request is disabled. 

Bttenpt to disable this request. 

H nessage request reply has conpleted. 



QLDEV.QLDEVN - Logical Device Nunber 

QHISC - Driver request dependent flags and counters. 



CHAN' ERR'FLG ■ 

RSTHT'FfllL'FLG - 

□PER*REQ , FL& • 

in'FAEJLT'FLG - 
RETRY 'COUNT 
LOAD'FLG 

SYS'PFRIL'FIG ■ 

UfllTCODE 



■ Channel error retry flag. 

■ Request status failed flag. 

- Operator requested release flag. 

■ Internal Maintenance fault flag. 

• Retry count area. 

- fledia load flag. 

• Systen pouerfail flag. 

■ Indicates type of wait: 

0 - neu request 

1 - conpletion uait 

2 - not ready uait 

3 - release/release deny uait 

4 - IOQ defer wait 

5 - DSCT read uait 

6 - DSCT write uait 

7 - synchronization uait 



QDSTN - If systen buffer is clear then this is the DST 
nunber of the target data segnent. If bit 0 is 
set then buffer address is a DB offset value 
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QflDOR - 
QFUNC - 



instead of segnent relative offset (inplenented 
for NOUfilT I/O and HQBUFF). 

■ Offset in data segnent or systeti buffer table to 
target data buffer. 

- Function code and qualifiers as specified by 
driver. 



OSTRT - PCB nunber and request conpletion status. 

PCBN - The Process Control 81ock (PCB) nunber of the process 
which nade this request. If zero, the request is not 
associated with any process and the 100 elenent is to 
be returned by the systen uhen the request has conpleted. 

STATUS - General status indicating the final state of the request. 

0 - Not started or auaiting conpletion. 

1 - Successful conpletion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

QUALIFIER - P. code uhich further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 
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SBUF Table Layout 



Table Elenent HUocation f SBUF) 



IMPEDED PROCESS PCB 



nflxinun of in use 



CURRENT IN USE 



TOTAL 
REQUESTS 



ENTRY 2 



INDEX OF 1 
ENTRY 3 



INDEX OF 2 



ENTRY 4 
(IN USE ) 



THEflD 
TTAIL 
TUSE 

TOVRFL 
TRQSTS 



The allocation of the elenents in the 100 terninal buffer (TBUF) and 
systen buffer (SBUF) tables is of concern to the I/O systen. 



FREE LIST OF TRBLE ELEMENTS 

These tables are in the forn of a free-linked list of the free elenents. 
For the SBUF's the -1 word of entry is the link to the next elenent. 
For the TBUF's, uord zero is the link and uord 1 is the link for the 
IOQ elenents. 

Each uord has an 11-word header beginning at the base of the table . The 
first six uords of the header are for Managing the table and the second 
five are for nonitoring table activity. 

The entries follow the header at uord eleven. 



ELEtlENT ALLOCATION 

Elenents are obtained fron the beginning of the free list, pointed to 
by the head and returned to the end of the free list pointed by the tail. 

Uhen the free list is enpty, the head index is zero and the tail index 
is set to point at the head index. 

The tables are divided into two areas: a prinary and a secondary area. 
Host requests are obtained fron the prinary area. The secondary area is 
used only for critical requirenents uhen the prinary area is exhausted. 
These areas are logical areas detertiined by paraneters in the header. 

The utility of the core resident tables is seriously reduced if their 
use is not restricted to dynanic situations. 

One of three responses nust be specified to the routines uhich allocate 
alenents fron the I/O systen tables. 

1 . Inpede caller if prinary is enpty. 

2. Get fron prinary area only. 

3. Get fron secondary area if prinary area is enpty. 
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Table Elenent Allocation (Cont. ) 

Request types 2 and 3 return an indication to the caller if the request 
could not be satisfied. The following table specifies the types of calls 
for elenent allocation and the action if an elenent is not activated. 



BUFFER USER CftLL TYPE 
SSUF's 

File systeti Inpede 

Ptape Inpede 

Dad track Prinary 

IOH's 

BTTACHIO (not inpedable) Prinary 

HTTflCHIO (inpedable! Inpede 

SIODH (nenory nanagenent) Secondary 

lOrtESSBOE Secondary 



Forget request 



Sudden death 
I/O error 



HERDER DEFINITION 



Prinary * 
Total • 
Size 

Inpeded PCS 

Head index 
Tail index 
In use 
Overflow 
Total requests 



' Nunber of elenents in the prinary area. 

Total nunber of elenents in the table. 
' Size in uords of each elenent. 
' If not zero then contains the PCB nunber of the 

first process waiting for an elenent in this table. 
' Index of first free elenent. 

■ Index of last free elenent. 

■ Current nunber not in free list. 

■ Nunber of requests nade for an elenent. 
' Total nunber of elenents requested. 
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ICS Mobil 



01 - 



. RESERVED 
SO. 

I 

49! CANDPIN 



481 LAST UEIGflT 
47| 

I PFWSETME 
461 



I- 



461 USTSTBTE 

I 

44| CUREFILTER 

I 

43| CURDFILTER 



42 CUTNUI 
41 
40 
39 



CUTDENOn 
CURCFILTER 
I1AXCFILTER 



3S{ MNCFILTER 
37 
36 
36 
34 



ESCHEDBASE 
DSCHEDBASE 
CSCHED8ASE 
UORSTEPRI 



33 1 UORSTDPRI 
| 

32) UORSTCPRI 



I- 



31 1 niSC. BOUNDS FLAGS 

| 

30 1 SYSTEn HEN BOUND 
| 

29 1 XDS UPPER BOUND 
I- 

28 1 01 INITIAL 
I - 
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I— 



27 1 



26 | XDS SEQUENT BANK 


Series 64 only 


25 


XDS SECflENT BASE 


Series 64 only 


24 1 XDS SEGMENT UNIT 
| 


Series 64 only 


231 PRIV BHDS STAT UD 


Series 64 only 


| 

221 






RESERVED 




19 






18 


DISAP 


PSEH, PSDB counter 


17 


Reserved 




16 


SDST 


process' stack DSTR 


15 


PSTA 


pseudo-interrupt status 


14 


PADDR 


pseudo-interrupt address 


13 


TRACE FLAG 


flag set non-zero on IXIT away fron 


12 


PFAIL 


PTR to pouerfail PCB 


11 


JCUT 


absolute JCUT address 


10 


XP 


pointer to executing process PCB 


S 


PCBX 


absolute stack address 


8 


Z 


stack DB relative 2 


7 


DL 


stack DB relative DL 


6 


S 


stack OB relative S 


5 


SBANK 


stack bank 


4 




STDB 


absolute stack DB 

\ 
1 


3 




0 


2 




P 


1 

1 


1 




STATUS 


1 


0 


P | 0 


1 



1 1/ 

OB BANK RETURN |\ 

| , FOR DISPATCH 

DB RETURN 



0 i 



PARH 



-1/ 



P=PSEUDO-DISPBLED RHD DISP INSTRUCTION EXECUTED. 
n:nT5PPTCHFR THTFSBLfPTFp, 
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ICS Global Cells Uith Initial Values 


CS 80 Disc Interrupt Linkaqe Table fILTl 


STDB - absolute address of the currently running process's stack. 

SBflNK - bank address for process' stack. 

S - stack OB relatives 

Dl - stack DB relative DL 

I - stack DB relative I 

PC8X - absolute stack address 

XP - PCB table relative pointer to word 0 of the running process' 

pee. 

The above cells are to be initialized for the PROGENITOR. 

CPCB - absolute 4, is an absolute version of XP. If CPCB is zero, 
then the above cells are invalid. This mil never be the 
case in a process. CPCB should also be set by INITIAL. 

SDST - DSTtt for running process' stack. 

JCUT - the bank zero absolute address of the JCUT table. 

PflDDR - PB relative address for the procedure PSEUOOINT. 

PSTF1 - status value for PSEUDQINT, Z140000+CST*. 

DISAP - PSDB counter, initially 0. 

INITIAL sets the above as described. 


There is one ILT for each device controller configured on the systen. R con- 
troller nay support nore than one unit, houever the CS'SO disc driver will 
only concern itself uith the single unit controller. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 flNEflONIC 

0| Channel | iCPVflO 
1| Progran | ICPVB1 
2! Variable j ICPVfi-2 
31 Rrea (ICPVfl) | JXPVR3 

4 1 Dilfl Abort | ICPVB4 
51 Address | ICPVR5 

fi l 0 [ ISRQL 

7|LI| CHANQUE I | CHflH | DEV | ICNTRL 

Z10| SYSDB relative pointer to channel progran area! ISIOP 

2111 SYSDB relative pointer to idle status area | ISTRP 

Z12I single instruction that is executed to extractl UNIT 
I the device unit nunber fron the status pointedl 
I to by ISTAP. [Since only Unit 0 exists on the I 
I CS'SO discs, RNDI 0 is used to return Unit 0] j 




Z13| SYSDB relative DIT pointer of the device i 
j currently using the channel to perforn a | 
i data operation. \ 


ICDP 




JE14| SIOPSIZE j CQUEN I 


I QUEUE 




Z15|RU|UP|IG| | HCUNIT | 


IF LBS 




Z16| SYSDB relative DIT pointer for unit 0 [ 


IDITPO 




Z17| 20 bytes status area for idle channel progran I 
'I • I 


ISTflT 




. | . j 

Z31 1 CS'SO Discs | 
Channel 

I Progran ; 






ICPVBO - Channel Progran Variable Urea 
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The first word is used by the channel progran processor to store status in- 
fornation after I/O channel aborts. The next uord is used by the driver to 
indicate if status should be exanined for special conditions or errors. The 
other two words are not used. 






ICPVfW - OUR abort address 






If a Otlfl abort occurs, the absolute address where the abort occurred is 
stored in this area. 






ICNTRL - Contains controller infornation 






U(1 -If this bit is set , the controller is sharing a software channel 
resource in order to linit banduidth. 






CHRHQUE -The software channel resource nunber. 






CHRH -Channel nunber (four nost significant bits of DRTN). 






DEV -Device nunber (three least significant bits of DRTN). 






IQUEUE - The channel progran contains: 






SIOPSIZE - (nunber of uords + 1)/2 in the channel progran area. 






CQUEN - er a «ulti-unit controller this field contains the 
software controller resource nunber. 






IFLflD - Controller and Channel Progran state flags 






RUHURIT - fln Idle Channel Progran should be started uhen there are no active 
requests to process. 






URITPROG - Rn Idle Channel Progran has been started for this controller. 
This bit is reset by an interrupt. 






IGHOREHI - fln HIOP instruction has been issued against this controller but 
the channel progran uas not in a wait statenent. Therefore ignore 
the interrupt generated by 






HCUNIT the channel code uhen this progran halts. - Highest configured unit 
nunber for this controller. 






ISTflT - 20 bytes of status fron the idle channel progran. 
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CHAPTER 14 SPOOLING 



Input Device Directory/Output Device Directory 
IDD/ODD (Comon attributes referred to as XDD) 



100: OST = 45 (= 155) 
SIR = 3 



Overview of Table Structure 



OST i 
SIR ■ 



46 (= ZSG) 
4 



0 I Entry 0 (8 uords) I 

• I i 

Z I Subentry area pointer | — 

• I I I 

7 1 II 

♦ ♦ I 

I I I 

I Head entries (4 uords each) I I 

I I I 

4 , I 

I I <-- 

I Subentries (Z40 uords each) I 

I I 
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Entry 0 (Overall Table Definitioni) 

0 1 2 3 4 5 6 ? 3 9 10 11 12 13 14 15 
♦--|--l--|~|--|~l"l-l--!--|--l--l--|~l"l"> 

01 naxinun size I Current size |0 (sectors) 
+ * ♦ 

1| Head entry size - 4 I Subentry size = 140 |1 ( uords ) 
+ r * 

2| Subentry area pointer (segtient relative) 12 

+--+ * 

3IDDI Next avail device file 10 (OFID) |3 

4I///////////////////////////////////I Fence |4 

S\IIIIIIIIIIIIIIIIIIIIIIIIIIIIIlll!lltlllllllllll\s 

6 1 'itiiiiiiiiiiiiiiiiiiiuiiiiiiiiiiiiitiitiiiiiiiM 

7 1 iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiniim 
* * 

DD: 0 ==> This is the IDO, 
1 ==> This is the ODD. 

Fence: For spooled output devices (000), the systen-uide out- 
fence. For spooled input devices (IDO), the jobfence. 
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Typical Head Entry (4 uords] 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l- 



Spooling 

Typical Subentry (Z40 uords) 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



-I--I-I-I--I- 



-l-l-l-l-l-l-l- 



-I- 



Oevice outfence I lllllllilltlllHlltllll I 



JO|//|State| Outpri ICLI///////////////////////I0 



Head pointer 



Tail pointer 
Logical device 



H I Type I 



Z2I 
Z3| 
Z4| 
ZS| 



Job nunber 



There are tuo types of head entry, a class entry and a logical device entry. 
There is only one class entry, if it exists at all, and it is the first head 
entry in the XDD. nil spoolfiles opened by class (e.g., LP, SLOULP, EPOC, 
PP, etc.) are linked to this entry. There is one logical device entry for 
each real (physical, as opposed to virtual) device on the systen. Output 
devices appear in the ODD, input devices in the IDO. RC/DC devices such as 
teminals appear in both directories. 

Each head entry is linked to 0 or More subentries (a typical subentry is 
shoun in the next table). R null chain (0 subentries) consists of head 
pointer - 0 and tail pointer = segnent-relative address of the associated 
head pointer. If one or nore subentries exists, the pointers are segnent- 
relative addresses of the first uord of the first and last subentries of the 
chain. finy internediate subentries are linked through the subentries. The 
tail subentry always contains a 0-link. 

The Device Outfence and LDEW fields are Meaningless far the class entry, 
for logical device entries (non-0 Logical Device field), a non-0 Device 
Outfence Means that this outfence overrides the systen-uide outfence in uord 
4 of entry 0, but only for this device. 



Z6| 
Z?l 
Z10| 
XII | 

2121 
Z13I 
Z14| 
Z1SI 

+- 
116 1 
Z17| 
Z20| 
Z21| 



11 

I? 
13 
K 
IS 

16 
|7 
IS 
19 

MO 
111 
112 
113 

14 
15 
16 
17 



Device file ID 



118 



Z23|FSI0fi|//l XDD head index (see explanation) 119 

+ — 4 — + — + r 

Z24| Logical device, or Device Class Table index |20 



Z25I Virtual LDEV nunber of open spoolfile 

+— 4 

Z26I Volune table index | Sector address. . 



121 

-4 
1 22 
I 



of spoolfile label. |23 



Z27| 

Z30| Nunber of extents 1 1 III III II II I II 1 1 1 III II l\ 24 

+ 4 4 

Z31 | Last extent size (sectors) |25 

4--4--4--4--4--4--4--4 4 

Z32]S0I//|RS|F0IS0|RBI//I Nunber of copies I26 

4~4--4--4--4--*--4--4 4 

Z33I Segnent-relative link to next subentry, |27 
I this device or class. 0 ==> last subentry. I 

4 + 

Z34| nunber of records in spoolfile (doubleuord) |28 
Z35| | 29 



Z36I Year 1100 100 

4 — 4 4_ 

Z37IDYI Hour (24 hr) | 



I Julian Day of Year/2 130 

—4 4 4 

Hinute I Seconds/4 131 
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Nott: Uordt 0-JEZ4 arc used in all subentries. Uords X25-X37, 

although present in ill subentries, art zero unless the 
subentry is for * spooled filt (spoolfile). 



Uord 0: State 



Word 1: Type - 



Uord 122: 10 

(lord X23: FS 

DA 

Head 
index 



Uord 224; 
Uord X2S VDEV 



Uord 126: VTIKX 
Uord Z3Z: SQ 



- State of subentry: 

0 ■=> Bctive 

1 «> Ready 

2 «> Open 

3 3t > Locked 

- 1 ==> Word 3E24 is a class index into the 

Device Class Table. 
0 ==> Uord X24 is the LDEV associated with 

this Subentry. 
Describes which environment created the 
subentry: 

0 «> Session' (SPOOK) 

1 ==> Session 

2 ==> Job 

3 ==> Job' (SPOOK) 

- 1 ==> Output DFID 
0 «> Input Of 10 

- There are one or no re ferns Message re- 
quests in the spoolfile. 

- The spoolfile uas created via a : DflTR record 
(input spooling only). 

- The (segnent- relative addmss)/4 of the 
head entry uith union this sub en try is 
linked. Since head entries are four words 
long, this can be thought of as an index 
into the head entry portion of the XD0--if 
you disallou values of 0 and 1 . 

- See description of Uord 0. 

- LPDT index of virtual device LDEV. Simu- 
lates the properties of a real LDEV to the 
process uhich FOPEHs a neu (previously 
non-existing) file (State field (X00(0). 
(1:2)) = 2 (Open)). 

- The volune table index of the logical de- 
vice in class SPOOL where the file label 
(first extent) of the spoolfile lives. 

- 1 »=> Squeeze (purge) spoolfile extents as 

the final copy is printed. Obsolete 
starting with COO. 20. 
0 ==> Purge only when final copy printed. 

- 1 ==> Restart job uhen uamstarting (input 

spooling only). 

- 1 =*> There are non-standard fonts on the 

device. 

- Spaced Out bit. File Systen could not ac- 
quire a neu extent uhen creating spoofile. 

- This is the tSTOUST of an aborted job. 

- Tine stanp uhen spoofile uas nade READY, or 
OD if not closed properly. Julian day is 
9 bits starting uith Uord Z36, bit 8. 
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SPOOK Tape fomat 



The overall fomat of output tapes produced by the SPOOK "OUTPUT" contend is 
shown below. The various consonants of the tape are then described in 
detail. The fomat described hem is subject to change as HPE evolves, 
filso, there nay be errors in SPOOK uhich uould cause the actual tape fomat 
to differ fron the one described hem in sons cases. Rll nuneric infomation 
is in integer fomat unless otherwise specified. 



EOF 
EOF 

Label Record 
EOF 

File Directory Records 

Device and Class Directory Record 

EOF 

Spoolfile 
EOF 

Spoolfile 
EOF 



flechanisns for End-of-tape and tape switching am the sane as for 
STORE/RESTORE tapes. 



Label Record 

words 0-13: 
Uord 23: 
Uord 24: 
Uords 25&Z6: 
Uords 30&31: 



"SPOOLFILETfiPE Lfl8EL-HP3000." 

reel nunber (first reel is nunber 1) 

date (fron CALENDAR intrinsic) 

tine (fron CLOCK intrinsic) 

"HPE V" if an APE V SPOOK tape 
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fill other uords are zero. 



file Directory 



The file Directory has one entry for each spoolfile on the tape. Each entry 
is 12 uords, and entries are packed into as nany I020uord records as needed. 
The last record will be padded uith zeros if necessary. The entry fomat is: 



Uord 


0: 


Device file id nunber (bit 0 is cr. tc indicate 
that the file is an output spoolfile) 


Uords 


1-3: 


zero 


Uords 


4-7: 


User nane 


Uordl 


8-11: 


Recount Wane 



Device and Class Directory 

The Device and Class Directory is contained in one 1024-word record. Them 
is no EOF separating this record fron the File Directory. This directory 
contains one entry for each logical device or device class linked to the 
spoolfiles on the tape. Rlso, there is an entry for each logical device in 
each class in the directory, whether or not that logical device uas directly 
referenced by a spoolfile. The entries am packed into the tape record one 
after another in no particular order. The entry fomats am shoun belou. 



Logical Device Entry 



Uord 0: logical device nunber 

Uord 1: Bits 0:8 : device subtype 

Bits 8:8 : 3 ("length of this entry in uords) 

Uord 2: device type 
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Device Class Entry 



Uord 0: Device class nunber (negated). This is the nunber 
of the entry of this device class in the systen" s 
Device Class Table. 

Uord 1: Total nunber of uords in this entry. 

Uords 2 on: The entire contents of the Device Class Table entry 
for this device eias*. 



Spoolfile fomat 

ODD entry (32-uord tape record) 

— > 



Spoolfile block 
Spoolfile block 



Two spoolfile blocks 
Two spoolfile blocks 



Two spoolfile blocks packed into one 
1024-uord tape record. 



The first feu spoolfile blocks have been nodified to contain user label in- 
fomation fron the spoolfile. This is explained later. 



Spoolfile Block Fomat 



A spoolfile block is a S12-uord block that contains variable length records 
in spooler fomat. Spoolfile records start at the first uord of the block. 
The last record is followed by a -1 to indicate that no nor? records follou. 
The last two uords of the block contain a doubleuord uhich is the record nun- 
ber of the first record in the block. 



Spoolfile Record Fomat 



Uord 0: Byte count of record - 2 

UonJ '; Byte count of data portion of record. Hole 
that this count includes trailing blanks. 
However, trailing blanks am truncated in 
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Uord 3: 
Uord 4: 
Uords 5 on: 



the actual record, so this count nay be 
none than the nunber of bytes actually 
present in the data portion. 

Function Code: 1=Fwrite 
2=Fcontrol 
3=F open 
4=Fclose 
Z100 and beyond=FDEVICECQNTROL 

P1 — RTTflCHIO parameter 

P2 — P.TTRCHI0 paraneter 

Data Portion of Record 
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Following this special group of blocks, the spoolfile resunes a nomal for- 
nat. The special FOPEN records all have the nunber of user labels in P2. 

It is often the case that sone of the 27 user labels have not been initial- 
ized before the tape is written. In that case, their places uill be filled 
uith garbage. There is no easy uay of detecting this except by careful 
inspection. 



User labels Infomation 



Spoolfiles have a nunber of user labels uith several kinds of infomation. 
These are: 

1. Haster: user label 0. 

2. FOPEN entry catalog: user labels 1-10. 

3. Circular queue for restart checkpointing: user labels 
11-27. 

Since older versions of MPE did not use user labels, a uay Mas needed to in- 
corporate then into the SPOOK tape format without losing forward and backward 
conpatibility. The nethod used is to add several special spoolfile blocks to 
the beginning of the spoolfile on tape. Each of these blocks has exactly one 
FOPEN record at its beginning. This record is followed by a -1 . Thus old 
versions of MPE will assune that the rest of the block is garbage. However, 
the rest of the block is actually used to contain user label infomation. 
The first two spoolfile blocks (i.e. the first tape record of the spoolfile 
proper) contain only the FOPEN records. The next 5 tape records actually 
contain user labels in addition to the FOPEN records. The user labels are 
packed 3 to a spoolfile block, 6 to a tape record. Each spoolfile block of 
512 words has the following fomat: 



Uords 0-4 
Uord 5: 
Uords X200-%377 
Uords X4CO-Z577 
Uords X60O-%777 



FOPEN record 

-1 (to "terninate" the block) 
user label 
user label 
user label 
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113*10 

urn rubber OF ENTRIES 

POSITION OF NEXT FREE ENTRY SPREE IN QUEUE 



NITOER OF ENTRIES 



NUBBER OF QUEUED ENTRIES 



(52 WORDS TO HOLD PINi'l OF QUEUED ENTRIES) I 

„ 1 



TABLE 5? 
HERDER ud 



UNUSED I 

BHllll»fl1HlllHfH»tllil»IUiHllfllHII j / 

PROCESS RUBBER (PIN) I 
OST* (FOR REPLY) '' | 



SUFFER ADDRESS (DST RELATIVE) 
BAX LENGTH OF STRING I REPLY TYPE EXPECTED" 



leg«1 



i'lag.1 



* BYTES IH BESSAOE 

BESSAGE IN ASCII 
(UP TO 26 CHARS.) 



— I 



! ENTRY 

(51 
Mil) 



NOTE: Proem Nunbtr ■ 0 neant entry it tnpty 
Rtply Iff* » 0 for nuneer (nun) 

« 1 for yet or no (y/n) 

» 8 for ttring (iwi) 

« 3 for yta, no, or STRING 
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.flag"2 

« 4 for ttring 
TABLE SHE > 2045 uordt 
.fleg«2 

BAX # OF ACTIVE ENTRIES » 3? 
BAX » OF QUEUED ENTRIES > 52 



Svttm G.n.r.1 Dttcriotion 

Tht mttagi tytttn eontittt of tht followng ptrtti 

- Ctllablt intrintic GENBESSAGE. 

- Uncallabli proctdure GENBSG uhieh it uitd by BPE. 

- Sytttn nettagt catalog (CfiTAL0G.PU8.SYS) end any nunbtr of 
uttr catalogt. 

- Proorin BRKECAT uhich buildl nltttgt catalogt. 

- BESSAGE SIR X24 

- BESSAGE SYSGLDB CELLS X371-373 
■ BESSAGE DATA SEGBENT 

Tht nttttgt tytten i< uted by calling GEHBESSAGE (or GENBSG) uith 
a neittge nunbtr. Tht nettagt tytttn fetehtt tht nttttgt f ran a 
ntttegt catalog, intern parantttrt, then routet tht nttttgt to a 
fill or rtturnt tht ntttagt in a bufftr to tht callir, 

A ntttegt catalog it a nunbtrtd tditor-typt filt containing »ttt 
of nettagtt. Tht Mtt ttrvt to break a catalog into nanagtable 
portiont. A ntttegt tytttn u»r nay Mil GENBESSAGE uting tithtr 
hit oun ntttegt catalog or uting BPE't catalog (CATALOG. PUB. SYS). 

Afttr creating a ntstage filt, run tht progran BAKECAT in ordtr 
to build a catalog that it rttdablt by tht nonage tytttn. Thit 
filt it Mill readable by tht tditor (it can bt "texted") but it 
containt a dirtctory (uritttn at a uterlabel). 

In ordtr to utt tht ntttag* catalog, tht progran nutt firtt opm 
tht ntttagt catalog, thtn call GEHBESSAGE uith tht filt nunbtr, 
ttt nunbtr and nettagt nunbtr. (HPE uttrt don't nted to optn tht 
catalog, GENBSG autonatically utn CATALOG. PUB. SYS.) Tht filt 
nutt bt optntd uith tht toptiont "NOBUF" and "HULTI" -record 
acotn. 



G.00.00 
15- 2 



Unified Contend Language 



ffnrat Wtlw 



Unifitd Connand Languagt 



THE 



Btttagtt in tht catalog can bt of any length and can contain up 
to fiv» parenttert. Continuation of a nettagt it indicattd by 
T or "t" at tht and of a lint. Tht T tynbol indicattt that 
tht nttttgt it eonUnutd and that a earriagt rttum, lint fttd bt 
ittutd tht ttminel. Tht "J," tynbol indicattt that tht ntttagt 
it continutd on tht tarn lint uith no earriagt return, lint fttd. 

Parantttrt nay bt inttrttd into tht nttttgt fttchtd fron tht 
catalog. Tht parantttrt art patttd in tht GEHBESSAGE (or GENBSG) 
call and inttrttd uhtrtvtr a '!" it found. For tht tytttn ntttagt 
catalog, tht bach tlath (\) it alto a paraneter, refltcting a 
logical device nunbtr. Tht ntttagt it routtd to tht titer attociattd 
uith that logical dtvict through tht :ASSOClATE connand. ntttagt tttt 
art indicattd by "tSET n« tttrtinj in eolunn 1 (tht rut of tht lint 
it trtattd « a conntnt), Baxlnun valut for n it 53. Comtntt 
can bt inttrttd in tht catalog by placing "t" in colinn 1, 
ntntgt nunbtrt art potitivt Intesert, nttd not bt contiguous 
but nutt bt in ateending ordtr. After proettting by tht progran 
BAKECAT, tht catalog fill containt record! of 20 bytet, blocked 
II, in 12 etttntt. (Tht tytttn ntttagt catalog it only ont 
extent, howtver). Tht fomat of tht ntttagt catalog it at 
follows 



(SET 1 SYSTEB HBSHSE5 

1 LDEV I! IN USE BY FILE SYSTEB 

2 LDEV *! IN USE BY MA6N0STICS 

3 LDEV IN USE, DOWN PENDING 
I IS "!" OH UDCW! (Y/HJt 



t BESSAGE 35 IS TUO UNES LONG, A PARABETER STARTS THE 
* FUST LINE ABO Tht SECOND LINE IS "HP32002" 
35 » 

#»»».«.( 



V% LDEV I FOR »!" ON ! (HUB)! 
tSET 2 CICRROR BESSACfS 

t? STREAB FACILITY HOT ENABLED: SEE OPESATOR, (CltRA 24) 
200 HOK THAN 30 PARSBETERS TO BUIU) COBBAHD, (CIERR 200) 



2M FILE CONBAHD REQUIRES AT LEAST TUO PAftABETEAS, INCLUDING 



FORBAL NABE OF THE FILE (CIERR 204) 



IMC"? f rwrw 

Tht progran BAKECAT. PUB. SYS it uitd to build mtiagi catalogt 
(and alto HELP catalogt). Tht pregran't input filt hat tht 
fomalditignator INPUT, uhich nutt bt nttd for all tntry pointt. 
Tht progran hat tht follouing tntry pointt: 

(no tntry - Rtadt fron input filt and buildt a ttnporary filt 
point) (fomalditignator CATALOG). Alto rtnantt any old 



ttnporary CATALOG, CATnn, utirn an archival ' 
nwbtring tchtnt (i.t., CAT1, CBT2, ttc). 

BUILD • (Butt log on undtr BRNNGER.SYS. ) Rtadt fron input 
filt, build tht tytttn mttagi catalog 
(fomaldtugnator CATALOG), and inttallt tht 
twnajt tytttn, Eititting catalog it renantd 
CATnnnn according to tht taut tchtnt at for no 
tntry point (above), InttaUation of tht nttttgt 
tytttn nttnt noving tht directory containtd in 
tht uttrlabtl of tht catalog into a data ttgntnt. 
Tht OST nunbtr and tht ditc addrett of CATALOG 
are plactd in tytttn global area. Tht ntttagt 
tytttn nay bt inttalltd uhilt tht tytttn it 
running. 

OIR • (Butt havt Pfl or OP capability. ) Inttallt tht 
tytttn ntttagi catalog (dott not build a ntu 
ont). Optnt input filt, novtt tht directory in 
tht CDTNLOG into a data ttgntnt, and placet tht 
OST nunbtr and ditc addrett of CATALOG in tytten 
global area, Thit nay bt dont uhtn the ntttagt 
tytten teent to be "broken", but the catalog it 
intact. (BPE it ittuing "HISSING BSG. SETwn. 
BSG«nn" at terninalt and at the contole.) Thit 
nay bt dont uhilt tht tytttn it running, 

HELP - Uttd to build tht HELP catalog. Rtadt input filt 
and buildt a HELP catalog (fomaldetignator 

HELPCAT). 
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Unified Connand Language 



tessage Systen CflTRLDC.PUB.SVS 



- Systen nessages. 

CI errors and warnings nessages. 

- fliscelianeous R80RT nessages. 

■ Progran error abort messages. 
' Intrinsics abort nessages. 

• Run-tine abort nessages, 
' C2 general nessages. 

■ File Systen error nessages. 

- Loader error nessages. 

■ CRERTE error nessages. 

■ ACTIVATE error Messages. 
SUSPEND error nessages. 
flYCOTMRMD error nessages. 

- LOCKGLORTN error nessages. 
Private Volunes error nessages. 
DS/3000 nessages. 

HELP facility error nessages. 
Graphic devices nessages. 

- Serial Disc error nessages. 
User Logging error nessages. 

■ Association Utility (RSQCTRBL) nessages. 

■ 2630A Page Printer nessages. 

■ 2680A Page Printer error file nessages. 
' Disc Free Space nessages. 

Systen Internal Error nessages. 



JSET 


t 


•SET 


2 


tSET 


3 


«SET 


4 


•SET 


5 


JSET 


6 


JSET 


7 


ISET 


8 


JSET 


9 


JSET 


10 


*SET 


11 


JSET 


12 


tSET 


13 


JSET 


14 


tSET 


15 


SSET 


16 


JSET 


17 


JSET 


IS 


JSET 


19 


JSET 


20 


JSET 


21 


JSET 


22 


JSET 


25 


JSET 


26 


JSET 


27 
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Heeeaqe Set Directory 

DST ft IN SYSGLOB 1373 

CRT DISC AODR IN SYSGLOB 1371-372 

CREATED BY RUNNING IffiKECIIT.PUB.SVS. 

KEPT IN fl DMA SEGMENT UNO IN ft USER LABEL. 



X DATA SEB1ENT 

o I max. set « 

II ft OF MESSAGE RECORDS 

I - 

2 I 



I- 
3 I 



4 I 
I- 

5 I 



RECORD OFFSET TO FIRST tlESSR&E 

FIRST HESSAGE » 
RECORD OFFSET TO FIRST MESSAGE 
FIRST MESSAGE # 



10 \ \ 
-I | HERDER 

H / 
-I 
12 \ 

I SET 1 
3 / 



USER 
LABEL 



5 / 



EMPTY ENTRY 



RECORD OFFSET TO FIRST HESSAGE |40\ 

• I I SET 63 

FIRST HESSAGE * |41/ 



53I RECORD OFFSET TO CURRENT HESSAGE |43/ 
I I 

54 1 BESSRGE |44 

I BUFFER | 

(640 UORDS) 



I- 



1253 
EHPTY ENTRY: 
RECORD OFFSET OF NEXT IN-USE SET 
-1 



I 

— I 
683 
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Unified Connand Language 



HELP Sutuvsten 



UPC Directory 



KEPT AS USER LABEL 
READ ONTO USER'S STACK 
USES SEARCH INTRINSIC FORMAT 
VARIABLE ENTRY SIZE 



•EXTRA DATA SEGMENT - DST It IN D6*Z255 OF UTIAIN STACK 
•BUILT BY INITUOC 



DIRECTORY SIZE (UORDS) 



ENTRY LGTH (BYTES) I KEYUORD LGTH (BYTES) 



ENTRY 
KEYUORD 



ENTRY RECORD • IN CICAT 
LEFT BYTE I RIGHT BYTE 



ENTRY LGTH (BYTES) I KEYUORD LGTH (BYTES) 



ENTRY 
KEYUORD 
1-255 BYTES 

I 

I ENTRY REC # LEFT BYTE 



ENTRY REC ft R. BYTE I ENTRY LGTH (BYTES) 
KEYUORD LGTH (BYTES) I 



ENTRY 
KEYUORD 
1-255 BYTES 



0 12 3 6 7 8 15 
LTILNINHINBI I TV I ENTRY SIZE 
HERDER RECORD NUMBER 
800Y RECORD NUMBER 
FILE NUMBER I COMMAND LENGTH 



ENTRY REC « 
LEFT BYTE I RIGHT BYTE 



COMMAND 
NAME 
(1-t6 BYTES) 



\ LT-OPTION LIST 
' LN-OPTION LOGON 
NH-OPTION NOHELP 
NB-OPTION NOBREAK 
TY- OO-USER UDC 
01-ACCOUHT UDC 
10=SYSTEM UDC 

ENTRY 



ENTRY SIZE=0 ENDS 
DIRECTORY 
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UDCs CDnnnHD.PUB.svs 

'RECORD SIZE = 20(10) UORDS, 6 RECORDS/BLOCK 
•KEEPS TRBCK OF UHO IS USING UHAT UDC CATALOG 
•CAN BE PURGED TO DISABLE UDCS 
•CAN BE REBUILT TO RE-ENABLE UDCS 



X RECORD 0 « 

I I 

C|1st FREE ENTRY • |0 

I I 

1 1 not used |1 

I I 

21 tlAX IN USE |2 

| 1 

31 * IN USE |3 
I— I 

41 14 
I not used j 

I I 
231 |19 



Z FREE ENTRY 8 
| 1 

OINEXT FREE ENTRY tt|0 
| 1 

1| ENTRY TYPE=0 |1 
I 1 

2| 12 
I I 
not used 

I I 

I I 

I I 

I I 

I I 

23I |19 

| 1 
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z 


USER ENTRY 


« 


Z 


I 

01 

I 


CATALOG ENTRY « 


•I 
|0 


I 

0| 


11 


ENTRY TYPE=1 


-I 
M 


I 

11 


1 

21 




I 

K 


1 

21 


1 


USER* 


! 


! 


3i 




13 


31 


1 

41 




I 

|4 


1 

41 


1 

51 




I 

|5 


1 

51 


1 

61 




I 

16 


1 

61 


1 

71 


ACCOUNT* 


I 

|7 


71 


1 

101 
1 




! 

IS 


1 

101 


111 
1 




I 

is 
I 


1 

111 


121 




no 


1 

121 


1 

131 


not used 


i 

in 


1 

131 


1 

141 




i 

M2 


1 

14| 


1 

151 




I 

113 


1 

151 


1 

161 




I 

114 


1 

161 


1 

171 




I 

115 


1 

171 


1 

20! 
1 




1 

116 


1 

201 


211 




I 

11? 


1 

211 


1 

221 




I 

MS 


1 

221 


1 

231 




I 

119 


1 

231 



connnHD.Pue.SYS (Cont.) 



FILE ENTRY f 
I 



FILE NABE 
I FOPEN FORtlflT: 

FILE 
t/LOCKUORD] 
GROUP 
ACCOUNT 
0 



110 
I 

I" 
I 

112 



I (UP TO 36 BYTES) | 



M3 
I 

1 14 
I 

115 
I 

116 
I 

117 
I 

118 
I 

119 



* IF THE USER FIELD AND THE ACCOUNT FIELD CONTAIN "8_ 
THIS INDICATES SYSTEn LEVEL UK'S. 



IF OHLY THE USER FIELD CONTHINS 8 AND 7 SPACES, THIS INDICATES 
ACCOUNT LEVEL UDCS. 
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0B«O 
D8«1 



DB+Z253 
DB+Z254 
DB*Z2SS 
DB+Z2S6 
DB*Z257 
DB+Z260 
DB*Z261 
DB*Z262 
DB*Z263 
D8*Z264 
DB*Z265 
DB+Z266 

DBtZ270 
DB*Z271 
DB+Z272 



CI Stack Definition 



BCOninAGE (Byte Ptr. To Connand) 



COnnflND MAGE 
(280 bytes) 



LINELENSTBCK 
(30 uords) 



NEXTHSG (Not currently used) 
THIS IS SPARE 
UDCO 
UDC1 
UDC2 
UDC3 
UDC4 
IFNESTING 
IFSKIP 
ELSESEEN 
CIFLAGS 



CONTINUE STATE STACK 
(2 uords) 



PENDINGCOHLEN 
BLBSTCOmnBGE (Byte Ptr.) 



LAST COnnAND MAGE 
(280 bytes) 



Unified Connand Language 
Field Definitions 



BCOfllflAGE: Byte pointer to COnlnAGE (sonetines called UCOniBHGE) 
in the CI stack. 

COfinfiHD inAGE: Connand character string currently being 
executed. 

LINELENSTBCK: A CI connand can span up to 30 input lines. This 

stack holds the length of each input line. 

NEXTHSG: Used to be used to link Messages together. No longer 
being used. 

THIS IS SPARE: Not used. 

UDCO: Holds the DST nunber of the UDC definitions. 

UDC1: Holds the old S register value for UDCs. 

UDC2: (0:1)— FLUSHUDC, used by :SETCHTRLOG 

UDC3: UDC options for current UDC. 

UDC4: (0:1)— UDC Fatal Ci Error 
(1:1)-I)DC EXIT8REAK 
(2:1i-UDC BREAKDETECTED 
(3:1)--UDC NOPRIHT 
(4:1)— UDC WAGEADJUST 
(10:6)-UDC NEST LEVEL 

IFNESTING: Level of nesting of :IF connands. 

IFSKIP: Uhether the current connands are being skipped as the 
false part of a :IF connand. 

ELSESEEN: Level of the :ELSE connands. 

CIFLAGS: (13:1)— Sequenced: line nunbers at rear. 
(15:1)— Not REDOable (last connand). 

CONTINUE STATE STACK: History of the : CONTINUE connands. 
= 0-no CONTINUE 
= 1— just seen 
= 2— in effect. 

PENOINGCOnLEN: If <> 0, connand is already in stack and this 
uord is the connand string length. 

BLASTCOnlnBGE: Byte pointer to last connand inage. 

LAST COnnAND MAGE: Uhen a connand conpletes execution, the 
connand string is copied here for use by the : REDO connand. 
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Association DST layout 



Not 
Used 



JIT DST Umber 



I- 



OST rel. index to user's next entry. 



I Class nane under uhich this ldev 
associated. Left justified and 
padded with blanks. 8 bytes. 



Don't 
Care 



16 



One entry/ 
systeti ldev 

\ 
I 
i 
I 

I- ldev 1 
I 

(Associated) 

I 

i 

I 

I 

\ 
I 

I 
I 



16 I- ldev 2 



I 

(Unassociated 

! 

I 

I 

I 

I 



JtlftT Index or 0 



JIT DST Number or 0 



Next Entry Pointer or 0 



j Classnane under uhich LDEV is 
I associated or undefined. 



7*n \ 
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CHHPTER 16 SYSDUMP/INITIBL 
COHFPRTR File 
Record 0 of CDNFDBTA File (CTBBO) 



l-l-l- 
Ol 

I 

11 

21 



10 
— -I 
11 

1 

12 



CHECKSUM OF CTA8 
CURRENT VERSION OF CTBB 



STANDARD STACK SIZE 
CORESIZE IN K UOROS 



TERMINAL BOUND PRIORITY 



NORMAL PRIORITY 
CPU BOUND PRIORITY 
« OF SECONDS TO LOG-ON 
LOG FILE RECORD SIZE (SECTORS) 
LOG FILE SIZE (RECORDS) 



101 

I- 
111 



1 2 1 /////////////////////////////////////////////// 1 10 

I 1 

131 LOG BITS (ONLY 11 USED) |11 



141 

151 « DEFINES UHAT IS BEING LOGGED» 

161 
I 

171 



20i 



DEFAULT JOB/SESSION CPU TINE QUIT 



112 
113 
IK 
I 

115 
-I 
116 



iiimiiiniiimiimiiiiiiiiiiiiiiiiitiiimi . 
iiiiiiiiiiiiiiiiiiuumiiiiiuiiiiiiiiiuiiii ■ 
iiiimimiiiimiiiiiiiiiiiiiiiitiiiuiniiii . 



341 

i- 



maximum open spool files 



1 28 



35 1 /////////////////////////////////////////////// 1 29 
| 1 

36| |30 

I maximum 8 OF SPOOL FILES (KILO SECTORS) I 
37| 131 

I 1 

40 1 /////////////////////////////////////////////// 1 32 

I 1 

41| tt SECTORS PER SPOOL EXTENT 1 33 

I " 1 
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Record 


1 of CONFDflTfl File (CTRB] 




01 


i i i i i i i i i i i i i i 
« OF CST ENTRIES 


lo 

j 


11 


8 OF DST ENTRIES 


M 
j 


21 
1 — 


* OF PCB ENTRIES 


12 


31 
[___ 


8 OF 100 ENTRIES 


| 

i3 
j 


41 

1 — 


* OF TERMINAL BUFFERS 


|4 
j 


51 


8 OF CST EXTENSION ENTRIES 


15 
j 


61 


INTERRUPT CONTROL STUCK SIZE (01 to Z1 ) 


16 


71 


* UCOP REQUEST QUEUE ENTRIES 


17 
j 


101 


8 BREAKPOINT ENTRIES 


IS 
i 


111 


* TRL ENTRIES 


!9 


1 — 
121 


8 LOCAL RINS 


I 

110 


1— 
131 


8 GLOBAL RINS 


I 

111 


141 
1— 


8 OF SYSTEM BUFFERS 


I 

112 


151 
1 — 


8 OF CONCURRENT PROGS 


I 

113 


161 


LOADER SEGMENT SIZE 


f 

114 


. imiiiiiitiiiiimiiiiiiiimiimimiimiii . 

■ HtiiiiimiiiiiiiiiiHini/iimimimmiii . 

■ lillfllllllUHIIIIIIIIIIIIflilllllllllllllllll . 


24 1 

t — 


SIZE OF VIRTURL MEMORY 


1 20 


251 


DIRECTORY SIZE (SECTORS) 


I 

121 



, imiiimiiiiiiniiiiiiiiiiiiituiiuiiiiiiui . 

■ miiiimiiiiiiiuiiimmiimiiiiiiiiiiiiii . 

■ imiiiiiiiiiiiiiiiiiiiiiiiiiiiiimiiiiiiiiiii . 
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CONDBTB (Cont. ) 



36 


MAXIMUM CODE SEGMENT SIZE 


130 


37 




MAXIMUM 8 OF CODE SEGMENTS/PROCESS 


-1 
131 


40 


MAXIMUM STACK SIZE (MAXDATB) 


--I 
1 32 


41 


MAXIMUM EXTRA DATA SEGMENT SIZE 


-I 
1 33 


42 


MAXIMUM 8 OF EXTRA DATA SEGMENTS/PROCESS 


"I 
I34 



. iimmtimmmiitiimiiiiiiiiiiiiiiiiiin 

. iiiiiiiiiiiiiiiiiiiiniiuiiiiimiiimmtiii . 

■ tiitimtitiiiiiiuiiimiiiiiiiiiiumtiiiiii . 
i 1 



i 



MAXIMUM « RUNNING SESSIONS |40 

MAXIMUM It OF RUNNING JOBS |41 
1 

8 LOG PROCS |42 
1 

LOG ID'S |43 
1 

# DISC REQUEST TABLE ENTRIES |44 
- " I 

# SPECIAL REQUEST TABLE ENTRIES |45 
I 

# PRIMARY MESSAGE TABLE ENTRIES |46 
I 

8 SUAP TABLE ENTRIES |47 
| 

8 SECONDARY MESSAGE TABLE ENTRIES |48 
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Sysdunp /Initial/Store 



DEVDATA.PUB.SYS 



PARAMETERS 
DRIVER TABLE 
LPDT 



LOT 
LDTX 

CLASS/TERM HEADER 



CLASS 
TERM DEF 



ADD'L DVR TABLE 
CS DEF 
C3 TABLE 



Paraneter Record 

0 
1 
2 
3 
4 
5 



CHECKSUM 
VERSION 
NEXT RECORD 
HIGHEST LDEV 
HIGHEST DRT 
NR. ADD'L DRIVERS 
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Sysdunp/Initial/Store 



REC * 

LENGTH 

SEC « 
LENGTH 

REC » 
LENGTH 

REC H 
LENGTH 

REC • 
LENGTH 

REC It 
LENGTH 

REC » 
LENGTH 

REC » 
LENGTH 

REC * 
LENGTH 

REC * 
LENGTH 
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The Driver Table consists of 7 uord entries, in correspondence to 
the LDEV entries, up to the highest LDEV used, entry zero is a 
dunny entry. 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

CRT It | 

--I 1 1--I 1 

CR| CHAN « | IDS j UNIT * | 



-I 

HflSTER LDEV 



TVPICRL ENTRY 
FORHAT 



OS DS DEVICE (if set DRT is jero) 

CR CORE RESIDENT 

CHRN * CHANNEL # 

HRSTER LDEV LDEV of device uhich this DS device is linked to. 
Uords 3-7 contain the driver nane. 
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SYSOUnP Fornat 



Sysdunp/Initial/Store 

STACK HRRKER 



CHECKSUM 
RBIGO CHANNEL PROGRAM 
UCS TABLE PRT 



-I < — ENTRY POINT 111 (ROM BASED 
I 0 HHCHINES) 



I 95 
-I 127 



--I 



UCS #1 
UCS #2 
UCS »n 



CHECKSUM 
AHIGO 



Only for the 64/68. Refer to the 
UCS Table for the 64/6S belou. 

< — ENTRY POINT K (UCS BASED 
0 MACHIHES) 



CST 



DEVICE CLASS TABLE HEADER 



DEVICE CLASS TABLE 
TERMINAL DESCRIPTOR TABLE I 



DISC COLO LORD INFORMATION TABLE 



CTAB 
CTfiBO 



conmiNicflTiOH record 

CSDVR 



CSOEF 
INITIAL'S DB ARER 



DRIVER TABLE 



LPDT 



INITIAL'S SEGMENTS 



LOGGING IDENTIFIER TABLE 



DIRECTORY HEADER 



DIRECTORY 



xxxxxxxxxxxxxxxxxxx EOF XXXXXXXXXXXXXXXX 
system progrrhs, sc non-std. drivers 



xxxxxxxxxxxxxxxxxxx EOF XXXXXXXXXXXXXXXX 
store/restore header 



XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 



STORE/RESTORE directory 



XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 



USER FILES (SEPARRTED BY "EOF's" 



STORE/RESTORE trailer 



XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 
XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 
XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 
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« NOT DUMPED IF DRTE = CARRIAGE RETURN 
NOTE: ON DISC, READ-S20-PROGRAM KEPT IN DISC LABEL. 
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Sysdunp/Initial/Store 



USC Table Fornat 



• Records to UCS 
« Records of UCS 

• Records after UCS 

UCS Record Size on Tape 



Note: Currently only one entry used (Entry 4, by Series 64). 

Series 64/63 UCS TABLE FORtlHT 



-I- 



128 Uord | UCS 
Header I 



-I 

I U1T 
I 

-I 



tlicrocode Version (8 Bytes ASCII) 



# of UCS LOCATIONS (64 Bit Uords) 

# of LOT LOCATIONS (32 Bit Uords) 



UCS CHECKSUII 
LUT CHECKSUM 
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First Voluhe 



Store T3pe Fornat 



xxxxxxxxxxxxxxxxxx eof xxxxxxxxxxxxxxxxxxxl 

-I 



XXXXXXXXXXXXXXXXXX EOF xxxxxxxxxxxxxxxxxxxl 



"STORE/RESTORE LABEL - 
HP/3000." 



|0 \ 
113 



114 

115 



PARTIAL FIRST FILE FLAG 
CHECKSUM 



DIRECTORY INDEX OF FIRST FILE 



116 
-I 
117 



US 
-I 
119 



VOLUHE NUBBER 



1 22 
-I 
123 



124 



125 
126 



-I 



TBPEBLOCKSIZE («U0RDS/BL0CK;def=4O96) 127 
-| 

128 



HEADER 
40 UORDS 



DATE: 

0:7 last 2 digits 

of year 
7:9 Julian date 

TIDE: 

25. (0:8) hours 
(8:8) flinutej 

26. (0:8) seconds 
(8:8) .1 sees. 



139 / 
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First Volune (Cont.) 



XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXXXX: 



GROUP NAME 
HCCT. NAflE 



XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXXXX 



FILES (separated by "EOF's") 



\ 

|TVP FILE 
I ENTRY 
1(12 UDS.) 
/ 



"Sysdunp/Initial/Store 



\ 
I 
I 
I 
I 
I 

I VOLUME 
I DIRECTORY: 
I # ENTRIES 
I DETERtllNED 
I BY TAPEBLOCK- 
I SIZE 
I 



\ 

I FILES 

I 

/ 
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Subsequent volunes 

1 

"STORE/RESTORE LHBEL- 10 
HP/3000." |13 
1 

"VIIB" |14 
115 

1 

PARTIAL FIRST FILE FLAG |16 FLAM: 

1tt FILE 

CHECKSUM |17 ON THIS 

1 VOL IS A 

DIRECTORY INDEX OF FIRST FILE |18 PARTIAL. 
, 1 

119 
1 22 

1 

V0LUJ1E NUIIBER |23 
1 

DATE 124 

1 

TIHE |25 
126 

1 

tapfbi nrKST7F 19? 

j~ 

128 
139 

I 
I 
I 

1 

FILE NAHE |\ 

| | TYPICAL 

GROUP NAF1E II FILE 
1| entry 

ACCT NAI1E 1/ 
1 

I 
I 
t 

1 

xxxxxxxxxxxxxxxxxx EOF xxxxxxxxxxxxxxxxxxxl 

1 

I 

<FILES> I 
(separated by "EOF's) I 
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HEADER 
40 UOS. 



/ NOTE: NO EOF. 



VOLUHE 
DIRECTORY 



\ 

I FILES 
I 

/ 



Sysdunp/Initial/Storf 



End of Volune 



KXXXXXXXHXXUXXKXXXXX EOf XXXXXXXXXXXXXXXXXX 



<FILES> 
(•eparited by "EOf' t) 



"STORE/RESTORE LA8EL-HP/300O.' 



FLAG: PRECEDING EOF HARKS FILE ENDED 



FLAG: PRECEDING EOF fIRRKS TflPESET ENDED 



VOUlnE NO. 
DATE 



124 



XXXXKXKXXKXXKXXXXXX EOF XXKXXXXKXXXXXXXXXX 



XXXXXXXXXXXXXXXKXXX EOF xxxxxxxxxxxxxxxxxx 



XXXXXXXXXKXXXXXXXXX EOF xxxxxxxxxxxxxxxxxx | 



FILES 



TRAILER 
40 UOS. 
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Labeled Tape Subtytttn 

ChRPTES 17 niSCELUWEOUS 
labeled Tape Subs? t tew 

The APE labeled tape subsystem pemits convenient acces* to tape* labeled to 
either ANSI or IBB standards. It operate* at a tet of subprocedures to the 
file system 0 labeled tape consists of one or nore logical files. Each 
logical file consist* of three physical files, i. e. tape areas de United by 
tapenartts. The First physical file contains header label*, the second con- 
tains the data, and the third contains trailer labels uhich art (except for 
ninor differences) espies of the header labels. The tape nark follouing 
trailer labels Mill be folloued either by header labels for the next file, or 
by another tapenarfc if there 1* no next file, labels are 80 byte* long, and 
conventionally are identified by their first four characters (three letters 
and a digit) and contain information as follows (CP :« character position; 
L:* length): 

WW: Present only on the first file of a volune, the volune label contains 
the volune identifier, uhich is usually .the minber on the tape strap, and is 
thus not expected to be changed. 



Labeled Tape Subsystem 



CP 1 Field Hint 


1 I 


1 Content 


1/3 | label identifier 


1 3 


I "VOL" 


4 I Label Nunber | 1 | "i» 


5/10 I Volune Identifier 

1 


1 6 


1 Vol ID 


11 I Accessibility 


| 

1 1 


| 

1 "0" if IBB, else " " 


12/79 I Not used 


I 62 


1 Slinks 


SO I Label-Standard Vernon 


I 1 


1 "1" if HP mi else " " 



UVLn: User volune labels, day be present on tapes fron Foreign shops, 
but are not uritten by lift. If encountered, they are ignored. 
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HDR1: First header label. Required for each file. Specifies: 


1 CP 1 Field Mane 


1 L 1 Content | 


1 1/3 I label identifier 


1 3 1 •■HOtr | 


I 4 1 label Nunber 


1 1 I "1" 5 


| | 

1 5/21 I File Identifier 

i I 


I E f i le nane, if tape Mas not I 
I 1? I written by WE, only the | 
j 1 first eight are significant.! 


I 22/27 I Volune Set Identifier 
I I 


j 6 j Nana* the volune on uhich | 
t f the set of files begins j 


I 28/31 | Reel nunber 

1 1 


I " i LtKJftlS LOW rTliS InaJT f 

1 I contain this file (1 starts) f 


i 32/35 ] File sequence nunber 

| ! 


I 4 j Counts the files in the set j 

1 | ST TUBS 11 %Xtrl%f | 


1 36/41 I Not Used 


1 £ | map upifM h 1 snaVee 


I 42/47 | Creation Date 

I I 


1 6 1 Year and day uithin year I 
1 1 then the file uas uritten. I 


I I 

! 48/53 I Expiration Date 

I I 


i I Year and day uithin year j 
1 6 1 when the file nay be over- j 
! 1 uritten uithout permission, j 


I 54 I Accessibility 


1 1 1 1230 if lockuord, "0" if IBH| 


I 55/60 I Block count 

| 1 


— 1 1 

i 6 1 Nunber of blocks if IBM. I 


I 51/73 I Systen Code 


1 1 

13 1 "HP APE 3000 " j 


I 74/80 | Hot Used 


7 ! Blanks | 


hDR2: Second header label. Although defined by the standard, nay be 
mssing on foreign tapes. Contains: 


I CP I Field Nane 


I 1 Content I 


I 1/3 I Label identifier 


3 1 "HOB" ; 


1 4 | Label Nunber 


1 1 "2" | 


1 1 

1 5 | Record Fomat 

1 1 
! 1 


1 "f" * Fixed | 
1 I "V . Variable I 
I "IT = Undefined | 
I Others treated as Undefined I 



a/10 | Block Length 



I 5 I Block length £in character j 

COO. 00 
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Labeled Tape Subsystem 



I fomat). 



1 11/15 | Record Length 
1 


i 5 i Record length (adhering to j 
1 1 to UPE rules) in characters. 


IS/23 1 Lockuord 
1 


— | 1 , 

1 » 1 APE File Lockuord. j 


1 24/35 ! Not Used 


...| 1 1 

1 13 I im urites blanks 


37 I Record Type 


t 1 i "fl" > BSCII | 
1 | "B* " Binary. 


38 1 Carriage Control 


...| 1 1 

1 1 1 "C" " control | 
] j " " » no control. ! 


39/80 | Not Ussd 
t 


1 42 | Blanks | 



Labeled Tape Subeysten 

User header labels: optional. Standard prescribes UHLn in the First 
faur characters, but nPE doesn't care. 

E0V1: End of Volune: used as first trailer label. Required if the 
logical file is continued onto another reel. Identical to HDR1 , except 
contains ths nunber of physical blocks of data in the data area. 



I CP I 



Field Nane 



I L | 



! 1/3 I Label identifier 

I I 

I 4 I label Nunber 



I 3 I "EOT 



IBM has a slightly different fomat. It is: 



CP 


Field Nane 


1 L 
--I 


Content 


1/3 


Label identifier 


1 3 

__ 1 


"HOP." 


4 


Label Nunber I 1 


"2" 


5 


"T" 

Record Fornat 1 1 

i 
1 


"F" ■ Fixed 

"V" = Variable 

"IT ' Undefined 

Others treated a* Undefined 


6/10 



Block Length 


1 

1 5 

1 


Block length (in character 
fomat). 


11/15 




Record Length 


-1 

1 5 
1 


Record length (adhering to 
to hPE rulee) m characters. 


16 




Not Used | 1 

1 


Blank. 


17 


IB". Position | 1 

1 


"0" * no volune switch 

"1" * a witch has occurred. 


IS/3* 


Not Used 


1 11 


Slinks. 


1 1 
39 1 IBM Slock Attribute. 1 1 
i 1 

. ! ! 


"9" * Blocked records. 
T * Spanned records. 
"9T « Blocked and Spanned. 
" " * No blocked or spanned. 


40/80 1 Not Used 


I 41 


Blanka I 



I 5/54 | Sana as H0R1 

| 1 

I I 

I 55/60 | Slock Count 



| 1 

I 61/80 | Sane as H0R1 



I 1 | "1" 

-I 1— - 

I 50 I 



] Nunber of data blocks since I 
6 j last beginning of file I 
j section label group. j 



I 20 



E0V2: Defined by the standard, but nay be nissing on foreign tapee. Follow 
E0Y1 : fomat sane as HDR2. 

E0F1: End of File; used as first trailer label. Required if this is the end 
of the logical file. Forest sane as E0V1. 

E0F2: Sane as E0V2 except used after E0F1. 

User trailer labels: optional. Standard prescribes UTLn in the first four 
characters, but fIPE again doesn't care. 
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Tape Label Table 

The tape label table ii the private playground of the tape label subsystem 
II consists of tuo parts: LDEV Control Blocks (LCBi) and Volune Control 
Blocks (VCBs). The L0EV are« is set up at systen initialization and contains 
one entry for tach tiagnatic tape LOEV and aerial due device in the systen. 
P.s is connon in m>£, the firit entry le a dunny uhieh telle -here the other 
things in the table are. The volune area contain* one entry for each labeled 
tape volune requested or active on the systen. 

although table entriee are atored in an extra data segnent, they are general- 
ly nanipuiated via local copiee on the stack. The proceduree HTIOEV and 
KTFHUH look for 10EV and volune intrie* ae apecified; they copy then to 
Hack buffers and return the OST addreie for uee in copying then back. 
POSTVTEMT copies the entnet back, and in the caie of a neu volune entry, al- 
locates apace for it in the volune taction of the tape label table. 

Initial uill build the "uninitialized" TIT a> follous: 

0 1 2 3 4 S 6 7 S 9 »0 It 12 13 14 IS 
I Size of ttje table, in uords (aluaya > 1) 10 
I Nunbar of LDEVS in the table " * i ' 

i"*' LOEV, IT I 2 

! ! 

Total of LOEVS (X) entriee of above 

! ! 

\ I 

Expansion area 
during SETUP' TAPES 
I | 

T: 1 if Tape drive 0 if not Tape driwe (i.e. serial due) 



labeled Tape Subsysten 

During PSOGCN, SETUP'TBPES 11 called to initialize, the table. The ove' 
structure of the initialized TIT is: 



TLTDST - 232, «26 
0 12 3 4 5 6 



TITSIR - 147, «39 
7 S 9 10 11 12 13 14 15 



Table initialization word (*1 uhen initialized) 



Entry size (ESIZE) » 132,426 



Table relative pointer to base of LC8 entries (LTSP.SE) (1) 



Table relative pointer to baae of VCB entries (VTBflSE) (2) 



Table relative pointer to top of Volune table (VTTOP) (3) 



Size of Tape Label Table, in uords (VTHRX) 



LOEV Control Block area -- one entry/nag tape drive 



Volune Control Block table -- contains VCB entries 
and free entries 



Area available for expansion of VCB table 
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The ICS entries have the following structure: 
0 1 2 3 4 5 « 7 J S 10 11 12 13 14 15 



| Type | T I I I B | HP| 

Logical device nunber 



Reel nunber 



File sequence nunbar 



Creation date 



Expiration date 



I 0 
-I 

I 1 
-I 

I 2 
-I 

I 3 
-i 

I 4 
-I 

I 5 
-I 

I 6 
-I 

I 1 

I 

I 10 



I 16 
-I 



(not used) 



Volune set identifier 



I » 
I 

I 21 
I 

I 22 
I 

I 23 
-I 
I 24 

25 

25 



ifolune identifier 
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Type: 00 • no tape nounted 
01 • unlabelled 

10 > BHSI 

11 > IBI! 

L: 1 if file has lockuord. 

T: 1 if device is a tape drive. 

B: 1 if tape is fron Burroughs, which has incorrect block/raccrd size 

in the HDP.2 label. Code can be patched to correct the size. 
HP: 1 if tape is Hewlett-Packard ANSI fornat. 

VCB address: Pointer to VCB entry describing volune nounted on 

tape drive, only if linked. Otherwise, 0. 
The VCB fomat is: 

0 1 2 3 4 5 S 7 8 9 10 11 12 13 14 15 

| p, | F I 0 I Position I U | SeqTypI LblTypI L I H I R I B I 0 

I 1 

I LOEV ■ I ' 

I 

PIK 12 

| I 

| File nunber (AFT index) I 3 

| I 

| File sequence nunber I 4 

| 1 

I S I R I 0 I C I Density I V I Reel nunber I 5 

I I , 

Expiration date I o 

: i 

! ! 7 

I File nane I 10 

I I 

I I 
I I 16 

I * I 

I I H7 

♦ - • 

| I 20 

! I, 

1 i n 

! - - !" 

! I 24 

] i 

I Vc.u^e set isenufier i ts 

I i 
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VCB (Cont.) 



I 27 

I 

I 30 



fi: RSCII FOPTION 

F: Flush bit - operator did REPLY <pm>,0. 
0: OEVREC Uait {used uith reelsuitching). 
Position: Gives head position within logical File. 

0 = at load point (LDPNT) 

1 = HDR1 label next (HI NX) 

3 = after H0R2 label (SH2) 

4 = after user header labels (AHU) 

6 = data next COMX) 

7 - after data (BO) 

8 = E0F1/ECV1 label next (Tim) 

10 = after EQF2/E0V2 label (RT2) 

11 = after user trailer labels (RTU) 
U: Write access specified. 

SeqTyp: File open sequencing type. 

0 = natch fiienane 

1 = HEX! 

2 = ROOF 

3 = use file sequence nunber 
LblTyp: Rs in LCB entry. 

L: Linkuait - nark left by C'.ERTETLTENT for LIHKLRBEL. 
fl: flount wait - waiting for operator to nount tape on FOPEH. 
R: Reelsuitch ualt - waiting for next reel. 
3: Susy bit - this entry is in use. 

lDEV <*: Logical device nunber of tape drive uith this volune, only if 
linked. Otherwise, 0. 

S: STORE tape. „„ 
R: REELSUITCH has been done. Used by STORE/RESTORE to handle STORE 

label ana directory file. 
D: Hext file is directory. Used by STORE. 
C: V0L1 label is to be created (uritten). 

Density: volune set density. During a volune set open, contains the 

density requested by the user in FOPEN. Once the volune set is 
open, contains the actual density of the volune set. Only 
valid For tapes on variable density tape drives. 

0 = default oensity for volune set open 

1 = 1600 8PI 

2 = 62SO BPI 

V: 1 if volune set is being opened. Reset after conpietion of FOPEH. 



5.00.00 
17- 9 



Labeled Tape Subsysten 

(including user labels) is naintained. There is a separate CASE leg for each 
such procedure, 

If an EOT reflective nark or an EOF in data is found, REELSUITCH is called 
(pr'ncipally Fnsn the file systen procedure MOVE) to call for the next 
reel, if any. If another reel is needed, the tape drive is set Unowned so 
that' RVREC uill be called to recognize the new tape uhen it is nounted. 
REELSUITCH returns to its caller uhen it is satisfied that an appropriate 
tape is nounted. 

Closing Files 

FCLOSE calls CHECKUL to handle uniting E0F1 and EOfZ if needed and resolving 
the tape position. If the disposition is 3, the tape is lift positioned at 
the next file. If the disposition is 2, the tape is supposed to be left at 
the beginning of the current file, but the code does not presently provide 
for reelsuitching if the present file began on a prior reel. 

flt present, ensuing volunes of a milti-volune set must be nounted on the sane 
drive as the first, nostly because neither the file systen nor STORE-RESTORE 
was capable of dealing uith LDEV changes in the niddie of a file. REELSUITCH 
reports the LDEV being used, houever, so that the capability of using a dif- 
ferent LDEV can be added in the future. 

Store-Restore 

Conpiicaiions ensue on labeled STORE -RESTORE tapes because there needs to bt 
a Fill directory at or near the beginning of each tape of a nulti-volune set; 
RESTORE uses this directory to detenune uhether the specified flle(s) can 
exist on this tape. Because the reel switching process would otherwise be 
".'sible to STORE-RESTORE, special bits (VCB'RSUDOHE and VCB'URITDIR) are 
kept to enable special intrinsic! callable by STORE-RESTORE to report uhether 
a directory need! to be written or is about to be encountered. 

The special procedure HEXTTBPEFILE is used by STORE-RESTORE in lieu of doing 
a FCL0S£(,3) Followed by an FOPEH to get to the next File. This penult 
e'eaner handling of both REP IV 0 and Forward Space (logical) File over a 
Reelsuitch, as well as saving the tine needed to tear down and reconstruct 
ail the control blocks. 

niscellaneous 

PVOUD is used by the 3H0UOEV connand processor (in SPOOLC0HS) to obtain the 
nane of the volune on the specified drive without having to know the struc- 
ture of the tape label table. For the sane reason, TGEIIHFO is used by the 
FFILEWFO intrinsic (in FILEIO) to get labeled tape information. 

Systen failure 86 in BPE is defined as a major problen in LABSEG. Generally 
speaking it is a problen "1th the TLT setup, far exanpll if LRBSEG cannot 
find an LDEV in the tabie. 
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Vol^e Recognition 

Volune recognition is the responsibility of OEVREC, which reads the first 
record or a'neuly-rcunted tape on an urcwred drive and passes the record to 
RVREC. RVREC nay see: VOtl in the First 4 oytes, m RSCII, in which case the 
tape is AHSI; V0L1 in the first 4 bytes, in EBCDIC, m which case the tape is 
13*1; Anything else, in which case the tape is considered unlabelled. 

If the tape is unlabelled, RVREC reports to OEVREC that no further action is 
required. If the tape is labelled, RVREC wants to see the first M0«1 label, 
so as.s DEV5EC to read another -ecord. (Unfortunately, DEVREC cannot be stop- 
ped >ong enough for RVREC to do Its own read.) when the H0R1 record is 
found, the volune entries can be searched to see if there is a pending 
request for this volune. If so. the waiting process is restarted. 

If the systen has been restarted with tapes nounted, there will not be inter- 
rupts to alert OEVREC. The procedure RECOGNIZE is called uhen needed to see 
lF any such tapes exist. 

Peeking a File 

FOPEH gets into the tape label code in three different places. The first is 
to cail CRERTETLTEHT, which parses the string passed in the F0RBSI1SG parane- 
tar to identlFy the labeled tape file required. If there is no existing cor- 
responding entry in the volune area, this is a volune set open, and a new 
volune entry is created. There nay be an existing entry (if the tape was 
FOPEHed and FCLOSEd with disposition 2 or 3), in uhich case there is an as- 
sociated LDEV entry for the drive on which the tape was left nounted by the 
prior operation: in this case, the new information is stuffed into the exist- 
ing volune entry. R bit (LImKURIT) is left set to nark the entry for 
LIHKLRBEL. 

The second entry is through LIHKLRBEL, which is called fron R (.LOCATE, fit 
this time, it is necessary to identify the LDEV to be used for the tape. aF 
no LDEV is associatsd, the LDEV entries are searched to see if the operator 
has a' ready nounted the required tape; if so, the volune and LDEV entries are 
cross-tied and LIHKLRBEL is done. IF the search turns up nothing suitable, 
the operator is requested to nount the appropriate tape, and the procedure 
waits for either a REPLY or for RVREC to discover the appearance of a 
suitable tape and restart the process. If the operator enters a reply, it is 
validated. 

The third entry is through POSITION, which is responsible for positioning the 
tape to the requested file. Rt the file, the H0R1 and H0R2 label are ex- 
anined as required to determine the File characteristics. 

Reading and writing Files 



Rll procedures which nove tape go through the catchall procedure CHECKUL, 
which takes care of necessary labeled tape doings. The code insures that the 
sequence: header labels (including user labels), data, 



trailer labels 
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Breakpoint Table 



DST = 30(10) = £36 

The break point table is divided into 2 sections: 

1) PCB BREAKPOINT EXTENSION TRBLE (PCB'BKPT'EXT) 
This table contains the heads of the breakpoint 

crams 

2) BSERKPOIHT ENTRY TABLE (BKPT'ENTRY'TRS) 
This table contains the actual entries 

General Layout 



| PCB'BKPT'EXT 

I 

I 



PCB08) 
I I - 



...» |„. 



SYS GLOBAL 

14:15 



225 | 



I I ! 

I |-\-\-\-\-\-\-\-\-\-\- 

I I I 

I | BKPT'ENTRY'TRB I 

I I I 

L.:r I 

i 

i i i 

i i 

i i i 



L = 'able locked 

S = S-ster break j 

points exist i ! 1 

> I 

r i 

i i 

i i 
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PC8 Breakpoint E«ttn«ion Table 
• ENTHIES | 

head systeh ust I 



etITRV SIZE » 
FREE ENTRY ■ 



* USEO USER ENTRIES I ACTIVE ENTRY . Index 1„ Entry 

ln bpaahpoint 



Breakpoint Table 

Active Entry 



0|1:2:3I4:S:6I?:I:9I0:1:2I3:4:5 



Breakpoint Entry Table 



2 
3 
4-t 



ENTRY (0) 

0 !* UOROS BREflKPQIHT TUB I 

1 I HEflC FREE LIST | 
I • UORO USEO | 



FREE ENTRY 
II: SIZE 
I FORUARO LINK 
I 89CKUAR0 LINK 



I BBK a UORO USED | 

j — ! 

I UNUSED | 



0 I 



IO|P:L:VI0:F:T|U:P:C|U: SIZE 
M : : I : : I :H: |P: 



UNUSED 
SL0CKLR8EL 



PLOC 
INSTRUCTION 

Lin* 
USERLSBEL 



CONDITION/COUNT 



COND DESCRIPTOR 



The breakpoint entry tablt confute of variable length entritl 
The mninun entry size it 7. 
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Breakpoint Entry Table (Cont. ) 

£NTRY(0).(0:1) ' FR: 

ENTRY(0).(':1) * P: 

EHTRY(0).(2:1) ■ L: 

ENTRY(0).(3:l) * V: 

£«TRY(0).(4:1) • 0: 

EHTRV(0).(5:1) = F: 
ENTRY{0).(6:1) = T: 
ENTRY(0).(7:1) » U: 
£N7RY(0).(8:1) > PR: 
EKT«Y(0).(9:I) * C: 
ENTRY(0).(10:1) = UP: 



ENTRY(1).(0:1) • B 

ENTRY(S) i LINK: 



FREE ENTRY 
1 = FREE 

0 - USED 

PRIVILEGED WOE BREAKPOINT 

1 = PRW. 

0 = NON-PRIV 
PROCESS-LOCRL BRERKPQINT 

1 = PROCESS-LOCAL 

0 ' SYSTEM 
VALIDATION BIT 

1 = INSTRUCTION IN ENTRY(S) 
0 = INSTRUCTION MOT IN TUB. 

DOUBLE TRAP 
t ' BRERKPQINT OSCILLATES SETUEEN 
P/P»1 

0 » NOT DOUBLE TRRP 
FRKE 'DUWIY' TRW 

1 = BREAKPOINT RT P»1 

0 = 8RERKP0UIT RT P (DRIS. LOC) 
TUO UORD INSTRUCTION 

1 = TUO UORO INSTRUCTION 

0 * NOT TUO UORO INSTRUCTION 
USER LABEL PRESENT 

1 = TRAP TO USER SUPPLIED LRBEl 

0 ■ TRflP TO DEBUG 
PERHSNENT BREAKPOINT 

1 * PERU 

0 • TEBPORflRY 
CONDITION/COUNT 

1 * CONDITION/COUNT SPECIFIED 

0 - NO COND/COUNT 
UPOflTING 

1 ■ ENTRY IN PROCESS OF BEING 

UPDRTED/REHOVED 
0 = NOT BEING UPDATED/REflOVED 
USER P LABEL NODE 
LINK 

0 = END OF CHAIN 
X>= INDEX NEXT ENTRY 



Breakpoint Table 

Breakpoint Entry Table (Cont.) 

COUNT 

T ! ! ORIGINAL CNT. | 
I » OF HITS I 



CONDITION 

2) | 0PERAN01 | 

I OPERAND? I 

I0PT1 (OPtZI !EWP | 



RE LOP • 



(8:8) RE LOP WISER: 

3 - LT 9 s LTE 

4 • GT 10 = GTE 

5 « £Q 11 = NES 
0PT1 -> [0:2) OPERflNOVS TYPE 
0PT2 -> (2:2) 0PER«ND2'S TYPE 

OPERBNO TYPES: 

0 -> CONSTANT (SINGLE UORO) 

1 -> ADORESS (DOUBLE UORD) 

3 -> INDIRECT ADDRESS (TRIPLE UORD) 

OPERAND FQRHS: 

CONSTANT -> 



I CONST 



I REG I BASE I 
I OFFSET I 

UNO. OFFSET! (TYPE 3 ONLY) 



-> (0:6) CORRESPONDING INDEX INTO 'REGY' 



3 


= R 


10 


= DL 


4 


= SY 


11 


= 0 


7 


= DA 


12 


= S 


S 


= DX 


17 


= ER 


9 


= OB 







-> !6:'0) SEG N/SRNK a 
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Breakpoint Table 



liner Request List CTRL) 



The systen clock interrupts every TOO ns, tilth the CR being automatically 
cleared. Fin exception is the Shared Clock Interface Measurement service 
uhich allows rates as fast as 5 ns. The interrupt handler is the procedure 
TICK. On entry, DB is pointing to the base of tiner request list. Besides 
timeout requests, the clock also controls tine slicing. 



NU11BER OF ENTRIES 
ENTRY SIZE (4) 
FREE LIST PTR 



/ 01 
I I 
I II 
ENTOI | 
I 21 
I I 

\ 31 It of days since last start 

I 

/ 4| qilflNTUn/100 ns 

I I 

I SI 

I I THE OF DRY* 

ENT1 | E| 
I I" 

\ 7 | YEAR | JULIAN DAY 

I - 

/SI PTR TO flOST ACTIVE REQUEST 

I 

9 1 TRACE UORD 
| 

10| 0 

i 

I — 

/12|A| CODE I INDEX OF NEXT 

I I - - 

1131 REQ 

ENT3I | 

I | TIHE TO SERVICE AFTER 
\ I REQUEST IN FRONT (UNIT* 100ns) 
| 

I 
I 

A: 0 if inactive request 
1 if active request 



HP-IB Systems only 
QTIBE 



ENT2 



dunmy tine 



assignable 
entries 

I 

I 

I 

I 
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Timer Request List 
TRL CCont.) 

CODE & REQ indicate the type of request. 



CODE: 


REQ: 


TYPE: 


0 


DITP 


Hangup 


1 


OITP 


Carrier failure 


2 


DITP 


202 turnaround 


3 


OITP 


Read 


4 


DITP 


Logon 


5 


PCBB index 


Delay 




to process 




6 


DITP 


LP not ready 


7 


OITP 


2640 


Z10 


Port mask 


llsg port timeout 


Z11 


DITP 


Block mode read 






timeout (30 sees) 


XI 2 


PCBB index 


Uatchdog timer for 




to process 


process 



The list of pending requests is kept ordered by tine with later 
entries at the tail. 

Z20-Z37 OITP SIO device tineout: 

DIT8. (code J on 
expiration, cleared 
on Tinereq. 



Z5/Z6 



For Series 30/33, DTIflE is 
tt of TICS (0.091457 ns) 
since last Midnight. 
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Tiner Request List 



tIPE User Logging 



rtPE USER LOGGING enables users and subsystens to log changes to data sets on 
disc or serial files. This "change" file can later be used to recover data 
lost due to a systen or progran failure. The log file can itself be used for 
auditing purposes. 



General Design Overview 



Hardware Environnent 



Ho special hardware is required to operate the systen. However, if logging to 
a tape file is desired, the hardware configuration nust include a tape drive. 
If there is no tape drive, then nay log to a serial disc class device. 



Softuare Environnent 



rtPE User Logging is an integral part of UPE. 
required. 



DEsign Narrative 



Ho other special softuare is 



User Logging enables users and subsystens to journalise additions and 
Modifications to UPE and subsysten files. The journal can reside on either 
disc or serial logfiles. 



Tiner Request List 

Error Recovery Description 



The error recovery nechanisns provided by User Logging are: power fail 
recovery and recovery fron systen failure. 

Power failure recovery applies only to tape log files since flPE provides 
adequate recovery for disc files during power fail. Uhen a power failure is 
detected, a nessage will be printed on the console asking the operator to 
place the tape drive back on-line. (If the operator places the tape on-line 
before the nessage valid data nay be overwritten). (To reset the tape drive 
the operator nust hit the load button until the tension returns to the drive. 
Then hit the reset button followed by placing the tape drive back on-line), 
fit this tine the log process will recover the file by rewinding to the load 
point and then foruard spacing to the point where the power fail occurred. 
Uriting to the log file will continue at that point. 

In the event of a systen failure, the wam start load option initiates 
recovery of User Logging files. In the case of a serial file, the file is 
read and conpared to the disc logging buffer. All records found in the disc 
buffer that are not on the serial log file are posted and a proper end of 
file written. If the destination file is a disc file, all records are read 
and verified and an end of file posted to the file. In order to continue 
logging to a User Logging file that has been recovered in this nanner, the 
logging process for the file nust be restarted using the console connand 
:L0G. 



Rny records in the buffer area of the logging buffer will be lost. 

User logging has been enhanced to work with labeled serial discs. 
Internally the log process handles serial disc (or cartridge tape) 
log files the sane as for tape files. 



User Logging consists of a logging process, a nenory buffer, a disc resident 
logging buffer (for serial logging) and a user defined destination log file 
on disc or serial nedia. 



The logging process has two functions depending on whether the destination 
file resides on disc or serial nedia. If the destination file is serial, the 
logging process perfoms all output to the destination file. If the destina- 
tion file is on disc, the logging process allocates additional space (ex- 
tents) as it is required by the user. 

The logging buffer is divided into communication and buffer areas. The con- 
nunication area is used to pass information anong the users and the logging 
process. This information includes status of the logging process and logging 
file, space renaining in the logging file and error infornation inportant to 
users or the logging process. The buffer portion of the logging data segnent 
blocks inputs into the logging file before the data is actually pasted. The 
buffer is flushed any tine a user requests to close a log file or uhen a log- 
ging process is terminated. (The buffer is also flushed by the begin/end 
transaction or buffer flush requests). 
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User Logging Table 



User Logging Tabic 



Design Structures 
User Logging Table 

ENTRY SIZE = #38 words 
OST Z33 

Table containing an entry for each activated user logging process. Each 
entry is created when the process is started, and deleted uhen the process 
terminates. (Via :L0G eotwand). The information is extracted fron the Logging 
Identifier Table (LIDTfiB). 



* 


ENTRY 0 


Z 


o ! 


NUMBER OF ENTRIES 


0 


1 | 


FREE ENTRY HERD PT. 


1 


2 I 


INUSE ENTRY HEAD PT. 


2 


3 : 


NEXT BUFFER NUMBER 


3 


4 i 


row » PROCESSES 


4 


5 


I1AX II USERS/PROCESS 


5 


6 




6 


7 i 


ENTRY SIZE 


7 



37 



NUIIENTRIES 

The nunber of entries in the logging table. 
FREE 

R table relative pointer to the First free entry in the logging table. (-1 = 
table full). 

INUSE 

R table relative pointer to the first entry in the logging table that is 
being used (-1 = no entries in use). 

BUFHUI1 

The nunber of the buffer associated with this logging process. Used to 
create the nane of buffer file if serial logfile. (i.e. ULOGxxkx.PUB.SYS). 

IWXLOGPR0C 

The naxinun nunber of user logging processes alloued. 
NAX'USR'PROC 

The naxinun nunber of users per logging process. 
LOGTBB'ESIZE 

The size (in uords) of each entry in the table. 



U0R0 ENTRIES 

NUI1EHTRIES 

FREE 

INUSE 

BUFNUfl 

IIAXLOGPROC 

nnx'usR'PROC 

LOGTBB'ESIZE 



LOGTBB 

LOGTBB(I) 

L0GTBB(2) 

L0GTR8P) 

L0GTR8(4) 

L0GTR8(5) 

L0GTRB(7) 
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User Logging Table 



User Logging Table 



Typical Entry 
II 
0 



LOGGING 
IDENTIFIER 



BUFFER 
NAME 



FILE 
NRHE 



27 


CURR HUTO | CURR TYPE 


33 


28 


LOG DEV 


34 


29 


LOG PCB It 


3S 


30 


SUITCH FLAG 


36 


31 


NEU BUTO I NEU TYPE 


37 


32 


ADDRESS OF 
LOGGING BUFFER 


40 


34 


SIZE OF 
LOGGING BUFFER 


42 


36 


FURD ENTRY PT 


44 


37 


BIIRD ENTRY PT 


45 



LOCK 
UORD 



24 
25 
26 



NunBER OF USERS 



BUFFER DST NO 



30 
31 
32 



TfiBINDEX 
BTRBINDEX 
DTNBINDEX 

LGNBME 

BNRtlE 

LFNAHE 

LFLOCKU 

LF GROUP 

LFACCT 

HUHUSERS 

DST 

STATUS 

LGAUTO 

LGTYPE 

LGDEV 

PIN 

LGSUITOH 

LGNEUAUTO 

LGKEUTYPE 

LOAODR 

BSIZE 

NEXT 

"REV 
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UORD INDEX TO CURRENT ENTRY 
BYTE INOEX TO CURRENT ENTRY 
DOUBLE INDEX TO CURRENT ENTRY 

BTBBINOEX 

BTABINDEX+8 

BTBBINDEX+16 

BTBBINOEX*24 

BTABINDEX+32 

BTABINDEX+40 

TBBINDEX+24 

TABINDEX+25 

TRBINDEX*26 

TFIBINDEX*27.(0:8) 

TBB1NDEX*27.(6:8) 

TRBINDEX+28 

TBBINDEX+29 

TABINDEX+30 

TRBINDEX+31. (0:8) 

TRBINDEX*31.(8:8) 

DTBBINOEX+16 

DTBBINDEX+17 

TRBINDEX+36 

TfiBINDEX+37 
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User Logging Table 



LGNAflE 

The nane of the logging process (logging identifier). 
BHflflE 

The nane of the disc buffer used if the logging process destination file is a 
serial file. This is a file that resides in PUB. SYS. The fornat of the nane 
is ULQGxxxx where xxxx is the buffer nunber padded on the left uith zeros. 



If the switch fl.-g is true, the following will be the fully qualified file 
nane of the new log file. 

LFHW1E 

The nane of the logging file. 
LFLOCKU 

The lockuord of the disc logging file. 
LFGROUP 

The group that the destination logging file resides in if the file is a disc 
file. 

LFfiCCT 

The account that the destination logging file resides in if the file is a 
disc file. 

NUHUSERS 

The nunber of users currently accessing the logging file. 
DST 

The dst nunber of the logging data segnent (L0G8UFF). (-1 = LOGfiUFF not 
created yet) 

STATUS 

The status of the logging process. 
INITIALIZING = -1 
INflCT = 0 

ACT = 1 

RECOVERING = 2 

LGAUTO 

True if the autonatic changelog facility was enabled. (Not used - for future 
use). 

LGTYPE 

The type of destination File of the logging process. 
DISC = 0 
TRPE = 1 
SDISC = 2 
CTAPE = 3 

LGDEV 

The logical device nunber of the disc logging file or the disc logging 
buffer. 

PIH 
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User Logging Buffer 

There will be one of these tables around for the life of any active user log- 
ging process. The table consists of three parts: 

COnnUNICHTIDNS RREA - Infomation about status of the process, etc. that is 
coHnon to all users of the process. Also the cells for nessages to/fron'the 
process. 

USER ENTRIES - Infomation for a specific user of the process. One 

of these for every user of a process (Setup by OPENLOG, released by 
CU3SEL0G). 

BUFFER AREA - Buffer used to hold logging records fron all users 

before writing to the log file. 



connuNicnnoNS area 




ENTRY #2 


|FPT|BPT| 
I I 1 


ENTRY S3 


IFPTIBPTI 
1 1 1 


FUTPV $A 


1 CDT 1 HOT ■ 




ENTRY HH 


|FPT|BPT 
1 1 


BUFFER RREfl 




4K UORDS 


1 
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The PCB nunber for the logging process (PIN * PtBSIZE). 
LGSUITCH 

Flag indicating a CHANGELOG is pending (if true). (Not used - for future 
use). 

LGNEUflUTO 

True if the autonatic changelog facility uas requested for the neu log file. 
(Not used - for future use). 

LGNEUTYPE 

If a switch is pending, this uill be the type of the neu log process. (-1 = 
no switch pending). (Not used - for future use). 

LGflDDR 

Sector nunber of the current extent in the disc logging file or the disc 
buffer file. (Disc buffer file has only 1 extent) 

BSIZE 

The nunber of records in the current extent (for disc logging) or the nunber 
available in the disc logging buffer. 

NEXT 

R table relative pointer to the next entry in the logging table. (-1 - this 
is last entry) 

PREV 

fl table relative pointer to the previous entry in the logging table. (-1 = 
this is first entry) 
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User Logging Buffer 



* 


COMUNICATIONS AREA 


Z 


0 


1 

J 

LOGGING | 
.1 

IDENTIFIER I 
.1 
1 
1 


0 


4 


SUITCH FLAG | 


4 


5 


NEU RUTO | NEU TYPE 1 

1 


5 


6 


AUTO | TYPE 1 
1 


6 


7 


BUFFER DST | 
1 


7 


8 


LOG PIN 

1 


10 


9 


NUNBER OF USERS I 
1 


11 


10 


HRX NUBBER OF USERS I 
1 


12 


11 


NEXT USER NUHBER I 
1 


13 


12 


SLEEP COUNT I 
i 


14 


13 


STATE i 
1 


15 


14 


nsG | 
1 


16 


15 


LOO I1SG 1 
1 


17 


16 


USER tISG 1 
1 


20 


17 


LOG ERROR I 
1 


21 


IS 


LOG DEVICE 1 
1 


22 


19 


BUFFER SPRCE 1 
1 


23 


20 


USED SPACE IN BUFFER 1 
1 


24 


21 


FILE SET NUrlBER 1 
1 


25 


22 


LOG | 
.1 

ADDRESS | 
1 


26 


24 


INPUT | 
J 

RECORD | 
1 


30 


26 


FILE | 


32 



L _i 
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User Logging Buffer 



User Logging Buffer 



34 
35 

36 



SIZE 
~fTLT" 



T0THL 
RECORDS 



flflX 
SIZE 



LfiST EXTENT 
EXTENT 



42 
43 
44 



4! 

49 



IN USE HERO PTR 



60 
61 



LOCID 




BLOGBUFF(O) 




SUITCH' 


= 


L0GBUFF(4) 




HEUBUTO 


s 


L0G8UFF(5).(O 


!) 


NfUTVK 


I 


LDGBUfF(5).(S 


8) 


BUTO 


= 


L0GBUFF(6).(0 


8) 


LOCTVPE 


= 


L0GBUFF(6).(8 


8) 


BDST 




L0GBUFF(7) 




LOGPIN 


- 


L0GBUFF(8) 




NUnuSER 


= 


L0G8UFF(9) 




flfiXUSER' 


= 


LOGBUFF(IO) 




USERNO 




LOGBUFF(H) 




SLPCT 




i ntAi\Fpii7\ 

Umjour r ^ i c j 




STATE 




L0GBUFF(13) 




rise 


= 


L0GBUFF(14) 




LOGtlSG 




L0GBUFF(15) 




USERftSG 




L0GBUFF(16) 




LOGERR 


= 


L0SeUfF(17) 




LOGOEV 


= 


L0GBUFFC13) 




BSPRCE 








BUFUSEO 


= 


L0GBUFF(2O) 




VSETNO 




L0G8UFF(21) 




LOGfiDOR 




DLOGBUFF(H) 




TUB! IF BET 




ULUvOurr \ 




FSIZE 


= 


DL0GBUFF(13) 




FSPflCE' 


= 


DL0GBUFF(14) 




TRECS 




DL0G8UFF(1S) 




fIRXF SPACE 




DL0GBUFF(16) 




LRSTEXT' 




L0GBUFF(34) 




EXTENT 




L0GBUFFO5) 




RESOURCE 




DLOGBUFF(IS) 




UHERD 




L0G6UFF(48) 




FHEflO 




L0GBUFF(49) 
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User Logging Buffer 



LOCID 

The nane of the logging process. 
SWITCH' 

True if log file switch is pending. (Not used - for future use). 
HEUfiUTO 

True if the autonatic changelog option has been specified for the new log 
file. (Not used - for future use). 

WUTYPE 

If a switch uas requested, this will be the type of the new logging file. 
(-1 c no SHitch pending} (Not used - for future use). 

fiUTO 

True if the automatic chsngelog option uas specified for the current log 
file. (Hot used - for future use). 

LOGTYPE 

The type of destination file for the logging process. 
DISC = 0 
TRPE = 1 
SDISC = 2 
CTRPE = 3 

BDST 

The data segnent number of this table. 
LOGPIN 

This is the PCB nunber for the logging process (PIN*PCBSIZE). 
NUnUSER 

The nunber of users currently accessing the logging file. 
tlflXUSER 1 

The naxinun nunber of i 



i allowed to access the logging file. 



USERNO 

The next sequential nunber to be assigned users accessing the systen. It 
will get increnented for every unique OPEN LOG - used as the log # in the log- 
ging record fornat. 

SLPCT 

The nunber of users currently uaiting for activation by the logging process. 
STRTE 

The state of the user logging process. 
INACTIVE ■ 0 
ACTIVE = 1 



fln internal Message word used to indicate an error or operator request. 
6 - Continue processing, all is fine. 

2 - Suspend - error reading buffer file or writing to serial file 

3 - Stop - set uhen issue : LOG logid.STOP or when an EOF condition is 
found on the disc log file. 
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User Logging Buffer 



LOWSG 

R nessages fron the logging process. 

6 - Continue processing, all is fine. 
15 - EOF - if there are no nore extents available to be 
allocated. 

12 - Disc space - could not allocate the new extent because 

no space left in the group. 
9 - Write error - error occurred while writing to log file 

USERHSG 

R nessages fron the user process. 

6 - Continue processing, all is fine. 

12 - Disc space - user process needs another extent allocated 
for disc logging. 

LOGERR 

Last error found. After changelog: 

+H - File Systen error nunber encountered 
0 - No error 

-1 - NeM disc log file uas not enpty 
-2 - Neu disc log file did not have file code LOG 
-3 * Neu disc file is too snail 
(Not used - for future use). 

LOGOEV 

The logical device nunber of the current extent of the disc log file or the 
disc buffer file (buffer file has only 1 extent). 

BSPRCE 

The anount of space, in records, that are currently available to the users. 
On the last block of the last extent, one record will be saved by the logging 
process so that the proper close infornation can be posted to the file - 
either the trailer record (if the log logging process is stopped) or the 
change* to' neu record because of an EOF condition (and the RUTO option had 
been specified). 

BUFUSED 

The nunber of records currently in the buffer. On all extents, except the 
last extent BUFSPflCE+BUFUSED = 32 (nunber of records in a conplete block). 
However, on the last block of the l?st extent this uill NOT be true since one 
record is aluays held in reserve by 'Lhe logging process. 

VSETNO 

This shows the order in the log file "set" of the currently opened log file. 
(Not used - for future use). 

LOGfiDOR 

The disc address of the current extent of the disc log file. If it's a 
serial file, this is the disc address of the disc buffer for the file. 

jflRljrjjer 

The record nunber of the next block to be written to the logging destination 
file or the disc logging buffer for serial files. (Used as an offset into 
the current extent for the writes - since each record is one sector in 
length). 
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User Logging Buffer 



FSIZE 

The current extent size of the logging destination file or disc logging buff- 
er file for serial destination files, (on the last extent this uill be the 
last extent size rtinus 1). 

FSPfiCE' 

The space in records that renains in the current extent of the disc logging 
destination file or disc buffer for tape destination files. (On the last ex- 
tent of the disc log file, this is the anount of space ninus 1). 

TRECS 

The total nunber of records written to the logging destination file (includ- 
ing those records currently in the buffer). 

HfiXFSPRCE 

The total file size, in records, ninus 1. (Need that last record to post 
close infornation). 

LflSTEXT' 

The extent nunber of the final extent in the disc logging file or disc buffer 
file. 

EXTENT 

The current extent nunber of the disc logging file or disc logging buffer. 
RESOURCE 

Used for resource nanagenent (i.e. locking the L0G8UFF). Fornat is: 
RESOURCE + 0 = Ouner PCB nunber 
RESOURCE + 1 = Head of inpeded queue PCB nunber 
RESOURCE + 2 = Tail of inpeded queue PCB nunber 
RESOURCE + 3 = Queue length 

UHERO 

fi table relative pointer to the first entry into the logging data segnerit. 
(-1 = no entries currently in use) 

FHEflO 

R table relative pointer to the first free entry in the logging data segnent. 
(-1 = no free entries) 
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User Logging Buffer 



BIHDEX 


BYTE INDEX TO CURRENT ENTRY 


INDEX 


UORD INDEX TO CURRENT ENTRY 


DINDEX 


DOUBLE INDEX TO CURRENT ENTRY 


USER 


■ BINOEX 


GROUP 


= BINOEXtS 


BCCT 


BINOEX+16 


UPIN 


IHDEXtU 


OPENCNT 


IHDEX+1 3 


USTRTE 


= IHDEX+14 


ERROR 


= INDEXH5 


LGNUH 


INDEK+16 


SCODE 


IHDEX+1 7 


RECS 


= OIHDEX+9 


NEHTRY 


INDEX*23 


PENTRY 


= INDEX*24 



USER 

The nane of the user uha opened the logging file through this entry, 
GROUP 

The group of the user uho opened the logging file. 
RCCT 

The account of the user uho opened the iogging file. 
UPIN 

The PCB nunber of the user process (PIN * PCBSIZE). 
OPENCNT 

Counter of hou nany tines this user called OPENLOG. (Increnented for every 
OPEN LOG, decrenented for every CLOSELOG). (Not used - for future use). 

USTRTE 

The wait status of the users process. 
INACTIVE = 0 
RCTIVE = 1 

ERROR 

Used to hold error infornation for this user. 

-1 = No rooM in disc (or disc buffer) and NOUAIT. 
0 = O.K. 

LGNUrl 

The logging nunber assigned to the user. (Fron USERNO in global area to be 
used as log fl in the log record). 

SCODE 

The subsysten code for the caller. This applies only to privileged callers. 
RECS 

The nunber of records written by this user. 



TYPICAL LOGBUFF ENTRY 



* % 



0 


USER 
NfltlE 


0 


4 


GROUP 

NRUE 


4 


S 




10 




ACCOUNT J 
NfinE J 




12 


USER PCB * 


14 


13 


OPEHLDG COUNT 


15 


14 


UNIT STATE 


16 


1S 


ERROR CODE 


17 


16 


LOG NUNBER i 


20 


17 


SUBSYSTEM CODE 


21 


18 


TOTAL i 
RECORDS "I 


22 








23 


FRUD ENTRY PTR 


27 


24 


8KURD ENTRY PTR 


30 
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User Logging Buffer 



"ENTRY 

H table relative pointer to the next entry in the logging data segnent. (-1 = 
this is the last entry) 

PENTRY 

A table relative pointer to the previous entry in the logging data segnent. 
(-1 = this is the first entry) 
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Logging Identifier Table 



User Logging Identifier Table 



ENTRY SIZE - »33 uords 
DST HI 



Table containing an entry for each potential logging process. Entries are 
added via :GETL0G and released via : RELIOG. 



Entry (K) 



nnx NunBES of entries 



ENTRY SIZE 



GENTRIES 
ENTRYSI2E 



LIDTRB(I) 
LIDTflB(4) 



ItENTRIES 

The naxir.un nunber of entries in the table, (i.e. Haximjti nunber of user log- 
ging processes. 1 entry for every process - activated or not). 

ENTRYSIZE 

The siie of each entry in the table. 
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Typical Entry 



LOGGING 
IDENTIFIER 



PRSSUORD 



FILE 
NRHE 



FILE 
LOCK UORD 



FILE 
GROUP 



FILE 
ACCOUNT 



24 I 
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Logging Identifier Table 



Typical Entry (Cont.) 



USER'S 
NRHE 



USER'S 
ACCOUNT 



Logging Identifier Table 

The group that the file resides in. 
FflCCT 

The account that the destination file resides in. 
UHP.HE 

The nane of the user Mho created the logging identifier. 
URCCT 

The account of the user -ho created the logging identifier. 
TYP 

The statue of the entry. -1 = null entry 

0 - disc logging file 

1 = tape logging file 

2 = serial disc logging file 

3 = cartridge tape logging file 



BYTE ENTRIES 




LID 


6LIDTRB 


PU 


BLI0TRB(8) 


FNflrtE' 


6LI0TRB(16) 


LU 


BUDTRB(24) 


FGROUP = 


BLIDTRB02) 


FflCCT = 


BUDTH8(40) 


UNHI1E 


BLIDTRB(48) 


UBCCT 


BLIDTRB(56) 


UORD ENTRIES 




TYP = 


LIDTRB(32) 



ud 

The logging identifier nane. This is a rtaxinun of eight characters long. 
PU 

The pass nord for the logging identifier. This is a tiaxinun of eight charac- 
ters long. 

The following is the fully qualified file nane of the current log file, 
FNPJ1E' 

The nane of the destination file. 



The lock word on the destination *ile if the file is on Disc. 
FGROUP 
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User Logging Record Fornats 



Logging Record Fomat 



RECORD SIZE = 1?8 uords 
USER BRER =119 uords 



LOG RECORD HT OPENUffi 
0 2 3 4 6 



— i — i — i — i — i — i — i 1 — r 

recS | cksun | code j tine 1 date | Iogid|logftl creatorlpcb | 

i I I I I I I I L 



USER OR SUBSVSTEH/CONTINUflTION LOG RECORD (fron URITELOG) 

0 2 3 4 6 7 8 9 127 



i i i i i i r~r 

I recti I cksun I code I tine [date i logt* I len I 
I i i I i I i_J. 



user area 



LOG RECORD AT ClOSELOS 
0 2 3 4 6 



24 25 



I 1 1 

I rectticksunlcode 
I I I 



tine I date 
I 



1 1 1 1 1 

logidllogttl creatorlpcb I ! 
I I I I I 



CRASH tlflRKER 

0 2 3 4 



i — i — i — i — r 

rectticksunlcode j tine I date I 
I I I I l_ 



HEADER RECORD (STBRT/RESTBRT) 

0 2 3 4 6 7 11 



i i i i i i r 

I rectticksunlcode j tine I date I logid I 
I I I I I I I. 
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User Logging Record Fornats 

TRAILER RECORD (STOP) 

0 2 3 4 6 7 



I I I I I I I I 

I rectticksunlcode Itineldatel logid I I 

i i i : i i i i 


NULL RECORD 

0 2 3 4 6 7 




127 


1 1 1 1 1 1 1 
1 rectticksunlcode Itineldatel I 
1 1 1 1 1 1 1 


BEGIN TRANSACTION I1RRKER 

0 2 3 4 6 7 8 9 




127 


1 1 1 1 1 1 1 1 
j rectticksunlcode 1 tine I date 1 logt* 1 len I 
1 1 1 1 1 1 1 1 


user area 


1 
i 
1 



END TRANSACTION MARKER 

0 2 3 4 6 7 



i — i — i — i — i — i — r~r 

| rectticksunlcode |tine|date|logSjlen| 

I I I I I I 



user area 



CODE DEFINITION 

CODE. (8:8) = 

1 Open log record 

2 User/subsysten record (uriteiog) 

3 Close log record 

4 Header record 

5 Trailer record 

6 Restart record 

7 Continuation of a user or subsysten record 
9 Crash narker 

10 End transaction record 

11 Begin transaction record 
SPACE NULL record 
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User lagging Record Fornats 



DRTfl FIELDS OF LOG RECORDS 



tleasuretient Information Table 
tlEflSINFOTflB 



DST = 59 [X 73) 



RECtt 


DOUBLE INTEGER 


CKSUtl 


INTEGER 


CODE 


INTEGER 


TIME 


DOUBLE (fron intrinsic CLOCK) 


DATE 


INTEGER (fron intrinsic CALENDAR) 


LOGID 


ASCII 


LOGS 


INTEGER 


LEN 


INTEGER 


USERBREA = 


ASCII 


CREATOR 


ASCII 


PCB 


INTEGER 



Reserved 
for BEASIO 
control 



1. The checksun algorithn uses the exclusive or (XOR) function against a base 
of negative one. 

2. Null record is used for filler. 

3. The code uord of the logging record can contain a subsysten code defined 
by the user in the first half of the uord (0:8). User logging allows 
privileged users to pass this code in the index paraneter of the Qpenlog 

intrinsic. 

4. The "len" field uill contain the entire length of the data in the transac- 
tion (i.e. the length passed to URITELOG, BEGINLOG, END LOG). If a continua- 
tion record is part of the transaction, it uill also contain the entire 
length of the data. For exanple, a length of 140 uas passed to the intrinsic. 
The "len" field of the first record Hill be 140, the "len" field of its con- 
tinuation record uill also be 140 - even though the actual anount of data 
found in the first record uill be 119 and the data found in the continuation 
record uill be 21 . 

(Positive length = It Hords, negative length = # bytes) 



I 10 

i 

I 11 

I 

I 12 

Reserved 
for 13 
perfornance 
tuning 1 
paraneters 

' 15 

16 

17 

20 



LDEV # OF MEASIO 
BEASIO P LABEL 
IIEflSIO DST II 



GLOBAL STATISTICS XDS NUMBER 
PROCESS STATISTICS KDS BANK 



PROCESS STATISTICS XDS BASE 
PROCESS STATISTICS XDS NLMBER 



CLASS 14 STATISTICS XDS BANK 
CLASS 14 STATISTICS XDS BASE 



HERS LDEV 
flERSPLAB 
HEHSDSTN 



HEASSTRTX- 
DSHUtl 



nEASPROC- 
XDSBANK 



NEASPROC- 
XDSBASE 



NEASPROC- 
XDSNUI1 
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fleasurenent Infomation Table 



27 | CLASS 13 STATISTICS XDS BUNK 

30 | CUSS 13 STATISTICS XOS BASE 

31 I CLASS 13 STRTISTICS XOS NUH. 

32 | CLASS 12 STATISTICS XOS BANK 

33 ! CLASS 12 STATISTICS XDS BASE 

34 | CLASS 12 STATISTICS XDS HUM. 

35 I CLASS 11 STATISTICS XDS BANK 

36 I CLASS 11 STATISTICS XDS BASE 

37 | CLASS 11 STATISTICS XDS NUH. 

40 | CLASS 10 STATISTICS XDS BANK 

41 | CLASS 10 STATISTICS XDS BASE 

42 | CLASS 10 STATISTICS XDS NUH. 

43 I CLASS 09 STATISTICS XDS BANK 

44 | CLASS 09 STATISTICS XDS BASE 

45 | CLASS 09 STATISTICS XDS NUB. 
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nea6urenent Infomation Table 



I 

reserved . 
for 
neasuretient . 
interface 





50 1 

j 




51 I 




52 | 




53 I 




- 

54 I 




- 

55 I 




- 

56 I 




57 I 




60 I 




- 

61 1 


reserved 


for 


62 | 


shared 




clock 


63 1 


interface 


user 


64 | 




65 | 




66 1 




67 | 



CLASS 0 ENABLED 
COUNT 



| CLASS 1 ENABLED 
I COUNT 



CLASS 2 EN.CNT. | CLASS 3 EH.CNT. 

CLASS 4 EN.CNT. I CLASS 5 EH.CNT. 

CLASS 6 EN.CNT. | CLASS 7 EN.CNT. 

CLASS S EN.CNT. I CLASS 9 EN.CNT. 



CLASS 10 EN.CNT. 
CLASS 12 EN.CNT. 
CLASS 14 EN.CNT. 



I CLASS 11 EN.CNT. 
I CLASS 13 EN.CNT. 
I CLASS 15 EN.CNT. 
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Heasurenent Infomation Table 



I 70 

i 

shared 71 
clock 72 
interface 73 
cells 74 
75 
76 
77 i 

100 ; 

101 

102 I 

reserved 103 j 
for 
event 104 
logging 

105 

106 I 



N I 



FLAG 
XDSI 
XDS2 
DCOUNT 



I A | 



DLIFfIT 
TCOUNT 



TLlniT 
D LABEL 



FIOHITOR BUFFER INDEX 
FIE AS BUFFER 



F1EAS BUFFER INDEX 
TIERS ENABLED FLAGS 



HERS ENABLED FLAGS 
TIERS BUFFER BANK 



SNONIDX 

HEAS8UF0 

REASIDX 

ITERSIISKO 

HEASHSK1 

HEASBUFBRNK 



116 

117 



fl: Interrupt has Hissed due to last interrupt handling. 
A: Current interrupt handling active. 
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rlessage Files 




CHAPTER 18 HESSRGE FILES 




Block Structure 




flessaqe File Data Structures 




| 1 ********************************** 


This chapter contains the data structures necessary to support nessage files. 
The first section details the nessage file's version of the faniliar file 
systen data structure; ie, the file label, file control block, access control 
block, etc, . 

The second section shows the tables used by the basic IPC nechanisn uhich is 
a set of internal, PIPE procedures designed to support the "boundary condi- 
tions" of IPC files. For exanple, signaling a no wait reader that its record 
has arrived. See the section's introduction for a detailed description. 

File Structure 


I First data record j 

j j c xac t sane fornat as standard 

I Second data record I variable length blocks. 

! Last data record 

I Record deliniter (-1 ) I 

| j ********************************** 

I Enpty space (next record j 
I uould not Fit) 


File Label/FCB Extent flap 




I Header deliniter (177) ; 




End of file block Start of file block 

! Disc addr of extent 0 | 


1 Last header record 




i ( 

i Disc addr of extent 1 1 v 
| | _ 

I Disc addr of extent 2 j 

1 1 

I Disc addr of extent 3 | 
1 1 




1 Second header record j 
I First header record \ 




\ \ 

! - 1 

I Disc addr of extent n-1 | v 
I I 
I Disc addr of extent n ! 
I----— I 




Separating the data portion of the records from their header enables the 
standard file systen access procedures to read the records uith no knowledge 
that they are nsg file records. 

Record Format 


The EOF and SOF are exanples only, Meant to shou: 










1) The start of file noves into the extent nap as records are read 

2) The file can wrap around and, hence, cause the SOF to be greater than the 
EOF. 


1 Nunber of bytes in record I 
| 1 

1 First data word of record I 




Hhen a file becones ertpty the SOF and EOF are reset to the first block of ex- 
tent zero. 

Each extent is conposed of a nunber of blocks. Extents all have the sane 
nunber of blocks. Extent zero also contains space for the file label and 
user labels in the exact sane fornat as standard files. Starting with block 
zero, sufficient blocks are allocated to the file label/user labels to satis- 
fy their space requirenents. 


| 1 

\ \ 
I" -—I 
1 Last data uord of record 1 
1 1 

Length uord's value does not include itself. 




Extents outside of the SOF/EOF range nay not exist. They are deleted at 
close tine uhen there are no nore writers accessing the file. 
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Dessage Files 


dessage Files 




Header Fomat 




9 1 


Block size (uords) ! 


11 « 


| , 




10 I 




12 


I C| LCI I Header Type I 0 
| 1 




11 I 


Carriage control code (uriters) \ 


13 * 


I Uriter's ID I -1 
i i 




12 | 


No wait I/D target f 


14 « 


C (0:1) - Set on if this was the last record written before 
the systen crashed. This bit is set on by the 
first open on the file after the crash. 

LC (1:1)- Valid only for close headers. Set to one if this is 
the last writer to close the file. 


13 I 


No uait 1/0 count j 


15 


14 | 


Error code j 


16 * 


15 | 


Transnission log (units sane as last read/urite) j 


17 « 


16 I 


Total nunber of unread records (includes opens 1 


20 


Type(8:S)- 0 data 

1 open 

2 close 
Hessaqe Recess Control Block 




17 I 


and closes) j 


21 




18 1 


Block nunber of the file's tail (relative to the | 


22 




19 I 


start of file block) j 


23 


Notes: 

1 . Hords/f ields that do not pertain to nessage files 
blank. 


are left 


20 I 


Logical record transfer count j 


24 


21 I 




25 


2. This diagran shows the "conbined" RGB as it appears to 

+k= -—--j..;,-- r+u- Tor* 


22 | 


Physical block transfer count | 


26 


Thus it is a conbination of the LflCB and the PRCS 




23 I 




27 


| _ 




24 I 


DST REL ADDR of Read Header I 


30 


-5 | DST nunber of the PfiCB 

I 


-5 


25 I 


DST REL BDDR of Urite header i 


31 


-4 I PfiCB control block vector table address 


-4 


26 I 


FC8 DST j 


32 


-3 | DST nunber of the LflCB 

I 


-3 


27 | 


FCB vector table offset j 


33 


-2 I 


-2 


28 I 


Share count ( nunber of LflCBs ) 


34 


-1 I 

| 




29 I 


Access class, status, etc. 


35 


0 | | Size of the flCB including buffers (uords) 


0 


30 I 


Logical device nunber 


36 


1 j File Nunber 


1 * 


31 | 


lUrt buf indxl | # buf - 1 I 


37 


2 j File narie 


2 * 


32 1 


OST relative address of next read record J 


40 


\ 


* 


33 | 


Size of the buffer (uords) i 


41 


6 j Foptians 


6 « 


34 | 


Spare j 


42 


7 | fioptions 

1 - 


7 * 


35 ; 


FRHVT index j 


43 


8 I Record size (bytes) 


10 * 


36 1 


Nunber of read LflCBs I 


44 


1 
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(lessage Files 



37 | Type and disposition 



I- 



3S j Access Mask 

I 

39 |0I# rd buf | « ut buf 



t Records per block 
ler |qu |n |c Id |i |f 



Nunber of free records 



40 I Rise, nsg file flags 

I - 

41 | hunter of free uord in the current free record 



Nunber of nondata records in the file 



46 Spare 

47 | Hopen records I It read requests 
last read error I last write error 
DST relative address of the next write record 
Spare 
Spare 

DST rel address of the PflCB 
DST rel address of the LfiCB 



DST relative address of the stack flCB 
Stack DST relative address of DB 



56 I Target area's DST nunber 



Reserved for calling paraneters 



I- 



Reserved for the stack narker fron file systen 



61 I intrinsics 



64 I User's soft interrupt plabel 

65 | Nunber of seconds to uait on boundary condition 

B.OO.OO 
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45 
46 
47 
50 
51 
52 
S3 
54 
55 
56 
57 
60 
61 
62 
63 
64 
65 
66 
67 
70 
71 
72 
73 

74 
75 

100« 
101* 



Hessage files 



66 







0/ 


nvyLy run l,Dii51l. IrL pun / 


103* 


68 


Uritcr Tft 
writer iv 


104* 


69 





105* 


70 


DST relative addr of nouait writer record buffer 


106* 


71 




107* 


72 


No uait I/O resultant urror cods 


110* 


73 


Ho uait I/O resultant transmission log 


111 


74 


write wait queue (basic IPC port) 


112 


75 


Read uait queue (basic IPC port) 


113 


76 


Length of record in bytes 


114 


77 


Head record's record type (sane values as header) 


115 








78 


Head record s writer ID 


116 


79 


H i cr f I mc 1 Parn rfi tunsr 
l llb^ ■ i A «y * r i»eLUlu tjf 


117 


80 


Size of record + count + header uords 


120 


81 


fnnnlptnr TD t Uaiter TH 


121 


82 


1 ne*.a 1 Plane 
LwCai. nags 


122 


83 


Ta rget DST nunber 


123 


84 




124 


85 


Length of target a rea 


125 


86 


Waiter' s reply port 0 if using RCB conpltn area 


126 


87 


Uaiting process ' s PIN 


127 


88 


waiting process's pin 


130 


89 


Waiter's soft interrupt plabel 


131 


90 


Resultant error code 


132 


91 


Resultant transnission log 


133 


92 


DST rel address of first buffer 


134 
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Message Files 



[ DST rel address of buffer tuo 



Hessage Files 



Uord Field Description 



* Value is private to a particular accessor. 
Uord Field Description 



ficcessor's local flags. 
(0:1) 0 1 - have not yet issued an FREflD/FURITE against 
the file. 

(1:1) ex 1 - extended uait node. 

(2:1) nd 1 - do not destroy the next record read. 

(3:1) vr 1 - uriter has not yet written his first record 

(ie. , he is a virgin). 
(4:1) bt 0 - transnission log should be expressed in uords. 

1 - " " " " " " bytes. 

(5:1) els - Not currently used (reserved for group IPC 

standard). 

(6:1) C - No wait conpletion Message is in LHCB area. 
(8:8) car ctl- carriage control character to be used for 

the writer's record (a value of one indicates t 

carriage control character). 



40 



File's global flags. 



(1:4) 
(5:4) 

(9:1) er 1 
(10:1) qu 1 



(11:1) n 1 
(12:1) c 1 



' nunber of read buffers 

nunber of urite buffers 

extended read 
' one or nore writers has been queued on the 

uait queue. 
■ uait nsg is located in the RCB 



■ conpletion nsg is located in the RCB 

(13:1) d 1 - the current urite buffer has dirty bit set 

(14:1) s 1 - the start of file is block zero 

(15:1) f 0 - the RCB buffers have not been filled 
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FinSTfiT Definitions 



Octal 
Value 


Event Type 


Paraneter 1 






Paraneter 2 


72/0 


Read init 


ft free rec 








72/1 


Read conpl 


(0:8) error, 


(8:8) 


ID 


Hunter of records 


72/2 


Urite init 


(0:8) t rec. 


(8:8! 


ID 


Nunber of free records 


mi 


Urite conpl (0:?) error, 


(8:8) 


ID 


Nunber of free records 


72/1 


Control 


(0:8) error, 


(8:8) 


ID 


(0:4) func, (4:12) pam 


72/5 


EOF 


(0:8) error, 


(8:8) 


ID 


Nunber of records 


72/6 


Open 


(0:8) error, 


(8:8) 


ID 


Nunber of records 


72/7 


Close 


(8:8) *free, 


(8:8) 


ID 


Nunber of records 


72/10 


Initiation 


0 






(0:8) Fix, (8:8) update 


73/0 


Put record 


(0:8) error, 


(8:8) 


ID 


(0:3) rec type, 










(3:13) nunber of records 


73/1 


Delete rec 


(0:8) error, 


(8:8) 


ID 


(0:3) rec type 












(3:13) nunber of records 


73/2 


Oelete blk 


Start of file block It 


End of file block » 



Notes: 

1. The aa/bb notation in the "octal value" colunn denotes type/subtype. Type 
is the actual flftSTHT event nunber. Subtype is (0|4) of paraneter 0. 

2. Several itens can possibly exceed their fields, in that case the bits 
beyond the field are lost. These itens are nunber of records, nunber of free 
records, start of file, and end of file. 
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File Systen Basic IPC Definitions 



The objective of this set of uncallable procedures is to provide a sinple ipc 
nechanisn to support the ipc file access procedures. It enables one process 
to send short, control nessages to another process. 

General Behavior 

FCPORTOPEN Procedure 

The heart of this nechanisn is the port, fl process desiring to receive nes- 
sages Mould first open (create) a port. This process is termed the "port 
nanager." Uhen the port is created, a port nunber is returned to the opener. 
Since the port nunber value cannot be known in advance, potential senders 
need sone tiethod of obtaining the port nunber fron the port nanager. 

Both the ports and the nessages are contained in a single disc resident data 
segnent. There can be a total of over thiry-five hundred open ports and out- 
standing nessages Thus neither ports nor nessage blocks are scarce 
resources. 



FCPORTSEND Procedure 

This procedure sends a 0 to 5 uord nessage to a port. Optionally a tineout 
value nay be specified which will Unit the duration the nessage uill renain 
attached to the port. Expiration of the tir.sout causes the nessage to be 
deleted fron the target port's queue and placed on the sender's reply port 
(specified by the sender in the FCPORTSEND procedure call). 

{FCPORTRECEIVE} 

Reads and deletes the head nessage fron a port. The sender's return port 
nunber is also given to the receiver, enabling hin to send a reply nessage. 

<FCPORTCL0SE> 

Oenolishes the port. 



Message Files 



3. Paraneter word 2ero has a connon fomat for all the HHSTBT events. 
Field Description 



(0:4) Event's subtype. 

(4:2) File's state 

0 - enpty 

1 - partially full 

2 - only a fraction of a free record is left 

3 - completely full 

(6:1) Nonzero indicates that there is one cr nore 

waiting readers. 

(7:1) Nonzero indicates that there is one or nore 

waiting writers. 

(11:1) Nonzero indicates that the urite has a carriage 
control character. 

(12:4) Flags local to the accessor. 

(12:1) - the accessor has done no FREHDs/FURITEs 

(13:1 J - extended wait 

(14:1) - nondestructive read 

(15:1) - writer has not uritten any records 
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Reader and writer wait Queues} R Uhen an enpty nessage file is accessed by 
nore than one reader (share), then there nust be a way of having the readers 1 
FREHDs satisfied in the sane order that they uere issued. That is, there 
nust be queue of Halting readers. The ipc access procedures acconplish this 
by dedicating a basic ipc port as a "read wait queue." Whenever a reader's 
request is stalled because the file is enpty, a nessage is sent to the read 
wait queue. Subsequent FREHDs by other processes uill queue up behind the 
first reader in a FIFO Manner, fin FURITE uill take the first entry fron the 
wait queue and send a "read nay be done" nessage to the reader's reply port. 

In a like nanner nultiple writers uill queue on the urite wait queue when the 
file is full. 

{Conpletion notification for nouait I/O) 

The IOUfilT intrinsic waits for a nessage to be sent to the reply port (s) of 
the specified user files. 

{Tineouts} 

Uhen an accessor encounters a boundary condition (ex, a reader accesses an 
enpty file), it nay specify that the condition nust be satisfied in x seconds 
(FCQNTRQL 4). To this end the ipc access procedures merely issue the 
FCPORTSEND to the wait queue with the user's tineout value specified. The 
tineout will tear the nessage fron the wait queue and place it on the acces- 
sor's reply port. 



{IPC file's use of this nechanisn} 

fill open nessage files have two ports open for the file (read wait queue and 
urite wait queue), plus one port per accessor (reply port). Their use is 
described in the following. 
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Port Data Structures 
Port Data Segnent 



Systeri D8 extension |Port OST #| 
+ 1100 



Port data segnent 



Remainder is 
cortposed of 
"block size" 
chunks. 



The chunks are a conbination of free entries, ports, Message queue 
entries, and tiner list entries. 



Port Uith Tuo Outstanding Messages 



I Port 



I fMJE 1 



I rtQE 2 | 
I I 



flessage Files 
Port Hunter 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 1fi 

— I"f"i"l"|--I"l"|--I"|--I"l"|--|--|--| — 
|Port index | Port data segnent relative addr/8 | 



Port index Index into the port OST nunber array 



Port DST Nunber Array 
Located in SysteH OB Extension Area. 



64 | Port data segnent nunber 

65 | Reserved for a second port segnent 



I 64 
-I 
I 66 



0.00 .00 
18- 13 



G.00.00 
18- 14 



Flessage Files 



Port Data Segrtent Global ftrea 



0 


Data segnent nunber of this port data segnent 


0 


1 I Block size in words 


1 


2 I 


Total nunber of blocks 


2 


3 I 




Haxinun nunber of blocks 


3 


4 I 


Current nunber of free blocks 


4 


5 I 


Nunber of open ports 


S 


6 1 


Head of free list 


6 


7 I 


Tail of free list 


7 


10 I 


Head of inpeded process list 


S 


11 I 


Tail of inpeded process list 


9 


12 | 


Head of tineout thread (TQE address) 


10 


13 I 


TRm of tineout 


11 


11 1 


Value returned by TIMER intrinsic when 


12 


15 I 


Tineout was initiated. 


13 


16 1 


Head of port list (in units of port nunbers). | 14 


17 1 


Not used. 


15 



flessage Files 
Port 

0 1 Z 3 4 5 6 7 8 9 10 11 12 13 14 15 

— |~I"IH--I--IH~I--I--|--I--I--I--I --I— 

0 I Head MQE address | 0 

1 | Tail mi address | 1 

2 |E | U | Next port nunber in poet list thread! 2 

3 |I |Subtype|Port Pin mmber j 3 

4 I Soft interrupt parameter one j 4 

5 ] Hunber of fttNfs in the port's queue | 5 

6 | Hunber of sends to this port f 6 

7 | Soft interrupt plabel | 7 

8 | PIN of port's owner | 10 
10 [1 |2 |3 |4 |5 |6 17 |8 |9 |10|11 |12|13|14|15| 

E Enable wake up bit 

0 - Oo not awaken the process 

1 - fiuaken the process 

U type Action to be taken on an enabled port uhen a Message 
received. 

0 - Awaken the process on a nessage uait bit. 

1 - Generate user software interrupt 

2 - Generate systen software interrupt 
I Interrupt node. 

Subtype Soft interrupt subtype 
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Hessage Files 



Hessage Files 



flessage Queue Entry (HQE) 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 IS 16 
___ M _.|„|._ M „|_-|_-|„ M „|„|__|„|„- 

0 | Next flQE entry; if last, (port addr) LOR 7 | 0 

1 | Port nunber of return port I 1 

2 |Tme List Entry (TLE),0=no tineout, -1=tined out| 2 

3 | Paraneter zero I 3 

I 4 
I 5 
I 6 
I 7 



4 | Paraneter one 

5 | Paraneter tuo 

6 | Paraneter three 

7 | Paraneter four 
|0 |1 |2 |3 |4 |5 |6 |7 |8 |9 |10 |1 1 |12|1 3|14| 15| 



Tiner entry definitions - 0 - no tineout 

1 - tineout expired 

2 - TLE address for a pending tineout 



File Systen Hessage files 



Uait Message 



parr# 

0 - 

1 - 



WRITER ID 

LOCAL FLAGS (differ uith each accessor) 
(0:1) - accessor just opened file 

(1:1) - will wait on boundary condition if no synbiotic process 

(3:1) - uriter has not written a record 

(4:1) - transmission log in bytes 

(8:1) - carriage control code 

DSTS of data buffer 

Rddress of data buffer (DST relative) 

Length of data buffer in bytes 



Completion Hessage 



0 - Resultant error code 

1 - Resultant transmission log in bytes 



G.Q0.00 
18- 17 



Tiner List Entry (TLE) 



0 1 2 3 4 5 6 7 3 3 10 11 12 13 14 15 
.._|_.|..|._|_.|_.|._|„[„|..|„ | __|__|„|_.|.„ 

Next TLE (sorted in incr tine val), 0 if last| 0 



Preceding TLE entry (0 if first entry) | 1 

Nunber of Milliseconds the tineout value I 2 
of this TLE is beyond the previous TLE. I 3 

I 4 
I 5 



Address of the affected flQE 
Address of the FIQE's port 



Value of TIHER when this tineout expires I 5 
(Milliseconds) I 7 

0 |1 |2 |3 |4 |5 IS |7 [S |9 [10|11 [12| 13|14|15| 



nriSTflT Definitions 



Octal Event Type 
Value 



Paraneter 0 Paraneter 1 Paraneter 2 



62 Open 



63 Receive 

conpletion 



65 Change 
status 

66 Abort 

67 Close 

70 Expand 

71 Tineout 
expired 



Port nunber 
Port nunber 

Port nunber 

Port nunber 

Port nunber 

Port nunber 

Port OST nun 

Port nun 



HQE address 
15:1 Uaitspc 



flQE address 
15:1 Q type 



0 = enable 

1 = disable 



Paraneter 
zero 



Port DST 



Flags paraneter 
Return port 

Return port 



Head HQE 
address 



Return port 



ff open 
ports left 



Total 8 
blocks 



# expand talks 
HQE address Return port 
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Henory Resident nessage Facility 


CHAPTER 19 flPE J1EH0RV RESIDENT nESSAGE FACILITY 


Return CC = CCG if process uas already awake else CC = CCE. 


Overview of Facility 


PORTSTRTUS 


The Hetiory resident nessage facility of HPE V addresses the need for an effi- 
cient, sinple, and uniforn nethod for systen code to send short status-type 
Messages to processes. 

Each process is created uith a "port" in the nessage harbor table (OST Z71) 
which supports a set of nessage subqueues which are private to that process. 
There is a naxinun of four subqueues per port in the initial inpletientation. 
This Unit can be easily extended when neu subqueues are required. 

Any systen code, even cede running on the ICS, can send a nessage to any sub- 
queue of any process. The destination process' PIN nust be known, any a 
priori conventions on subqueue nunber and Message fornats nust be es- 
tablished. The caller of SENDflSG nay optionally specify that the destination 
process be awakended fron a nessage wait. 


Logical Procedure PORTSTBTUS(Subqueue); 
Value Subqueue; 
Integer Subqueue; 
Option Privileged, Uncallable; 

Uhen supplied a valid subqueue nunber, PORTSTATUS returns a true value if the 
subqueue is non-enpty and a false value if the subqueue is enpty. 

Uhen passed a -1 a subqueue paraneter, PORTSTATUS returns the subqueue nunber 
of the process' nost urgent non-enpty subqueue (the snaller the nunber, the 
nore urgent the subqueue). 

If all subqueues are enpty, PORTSTATUS returns CC - CCE. If at least one 
subqueue is non-enpty, PORTSTRTUS returns CC = CCG. 


Message can be any length up to the configured naxinun. Hessage length is 
specified in the call to SENW1SG and RECEIVERS!). In the initial inplenenta- 
tion, messages are United to 4 words in length. This itaxinun can easily ba 
increased if the need arises. 

By calling PORTSTATUS, a process nay at any tine deternine whether a 
specified subqueue is non-enpty or obtain the subqueue nunber of the nost ur- 
gent non-enpty subqueue (louest nunbered one). 


RECEIVF-tlSG 

Procedure RECEIVEPISGt Subqueue , flsgLength, Flags); 
Value Subqueue, flsgLength, Flags; 
Integer Subqueue, flsgLength; 
Logical " Flags; 
Option Privileged, Uncallable; 


By calling RECEIVEflSG, a process nay receive the Message at the head of the 
specified subqueue. This receive is optionally non-destructive. 


Subqueue and flsgLength has better be Mithin range or a Systen Failure 622 
will occur. 


A process can wait on a nessage uait, or on a conbination of nessage wait and 
other uait types. 


The caller of RECEIVEnSG does an RSSEfl8L£(flDDS flsgLength) to nake space for 
the nessage contents. RECEIVEnSG stores the nessage contents into Q-8, 
0-9,...,0-7-nsgLength. Q-7-PlsgLength contains the first uord of the nessage. 


flessaqe Intrinsics 

SENOflSG 

Procedure SENDf1SG(Destpin, Subqueue, flsgLength, Flags); 
Value Destpin, Subqueue, HsgLength, Flags; 
Integer Destpin, Subqueue, flsgLength; 
Logical Flags; 
Option Privileged, Uncallable; 


Flags. (0:1) ==> do not release nessage fron head of subqueue (non destructive 
read). 

Return CC = CCG if all subqueues uere enpty, else CC = CCE. 


Destpin, Subqueue, and flsgLength have to be within range or a Systen Failure 
622 uili occur. 




The caller of SENDHSG stacks the Message contents before calling the proce- 
dure. SENDHSG expects the first nsg word to be at G-7-I1sgLength, and the 
last nsg word at Q-S. The nessage contents at 0-8 to Q-7-nsglength are 
deleted fron the top of stack by the exit fron SENDHSG to the caller- 




Flags. (1:1) - 1 ==> Uake-up destination process fron a nessage uait. 
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Henory Resident Hessage Facility 




Supporting Data Structures 




flessaqe Harbor Table f DST K57 [X701 




0 I DST Index Nunber (Z71) I 




1 | Data Segnent Size I 




2 I Reserved I 




3 | tlaxinun nunber of PINS + 1 | 




4 | tlaxinun nsg Size (6) I 




+ + 

5 I Reserved I 
+ + 




6 I nessage Pool Head Pointer j 




7 | flessage Pool Tail Pointer j 
+ + 




8 | Available Hsg Franes Count I 




9 I Head of inpeded queue I 




10 | Tail of inpeded queue I 




11 | Reserved I 
I t 




13 I Ports (16 uords each) | 
I (8 for header * 2 link uords j 
I for each of 4 subqueues) j 




I flessages (6 uords each) | 
j (2 for header + A for data) I 




G. 00.00 

] 19- 3 













nnSTATS Events 


nnSTATS Events 




CHRPTER 20 


HHSTflTS EVENTS 




FCLOSE 81 121 (-) * SYSPINS 225 341 (-) 










FCOHTROL 71 107 (-) * SYSPINS 226 342 (-) 












FETCHSE6 4 004 « SYSPINS 227 343 (-) 




nnSTATS Catalog Index 




FDETINFO 75 113 (-) * TERn LOGOFF 235 353 (-) 












FIND OE 18 022 * 












FLOCK 78 116 (-) * TERR LOGON 234 352 (-) 


EVENT NfltlE 


EVENT HO. 




tvtw 1 KHnt 


EVENT NO. 


FBPEK7(DB) 60 074 (-) * TERHREflO 230 346 (-) 


DEC. X 




DEC. X 


FOPEH/(DA) 61 075 (-) « TERWJRITE 232 350 (-) 










FPOINT 70 106 (-) * UH_nRP_RG 88 130 


RLCSTBLK 


20 024 (-) 




FREAD 


62 076 (-) 




RLLDCflEn 


12 014 




FREADDIR 


64 100 (-) 




BINREAD 


233 351 (-) 




cdcofi i que i 


76 114 (-) 




BREAK 


237 355 (-) 




FREADSEEK 


68 104 (-) 




C ABSENT 


139 213 






80 120 (-) 




CfifiORTIO 


142 216 




r RtHHnt 




CACHEMQV 


14 016 


t 




72 110 (-! 




CC LOSE 


146 222 




r jt i nuut 




CCLOSETRftCEFILE 


154 232 




FSPflCE 


69 105 (-) 




rrnwTRni 


152 230 




cnui ftrv 
rUnLULK 


79 117 (-) 




CDT ATT 


86 126 






66 102 (-) 




C GARBAGE 


7 007 


k 


FUPDnTE 




CONFIG- INFO 


221 335 (-) 




FURITE 


63 077 (-) 






222 336 (-) 




FURITEDIR 


65 101 (-) 




CONFI&-INF0 


223 337 (-) 




n IDTT C 1 QQC 1 


77 115 (-) 




COPEH 


140 214 




GIPINTERRUPT 


192 300 










GET_CDT 


15 017 




CQPENTRACEFILE 


153 231 




IOBUFTRAP 


125 175 




CPOLLIST 


1 55 233 


4 


Tin rnMiCTTlll 
I/O LUnPLttiUN 


111 157 (-) 








± 


TUTTTOTC 

INi 1 in 1 1 


84 124 




CREAD 


147 223 




IOUAIT 


67 103 (-) 










LINK_REG 


89 131 




rRFflm 


147 240 


% 


OflKEOC 


1 001 










nop nnn 


87 127 




CSDRIVER 


150 226 


* 


MnUTUTT 


228 344 (-) 




CSIOUAIT 


144 220 




{10N0FF 


223 345 (-) 




CURITE 


149 225 




PROCESS COMPLETE 


211 323 (-) 




DC1DC2ACK 


231 347 (-) 






0 000 










fa ic i no 


16 020 




nrm i nrn 


13 015 


* 


QUIESCE 


40 050 




yttlLw 1 DLn 


21 025 (-) 


* 


RELRESOURCES 


23 027 (-) 




* 


REQCfiCHE 


90 132 




DISKBUGCPJCHER 


200 310 


* 


SEGIOINIT 


5 005 








* 


SIOOn-EMTRV 


194 302 




flTSkBIIWHTrHFH 


201 311 


± 


sioon 


195 303 






100 144 (-) 


* 


SIODONE 


6 006 






t 


SOFT' DEATH 


120 170 




DISKERROR 


101 145 (-) 


* 


spec™ 


236 354 (-) 




DISKINTRPT 


191 277 


t 


SPECIALRQ 


2 002 




DQUE_LDR 


17 021 
















SPECREAD 


238 356 (-) 








* 


START I/O 


193 301 








* 


STRATEGY 


83 123 




DISK TRAFFIC 


98 142 (-) 


* 


SUAPIH 


8 010 




FCHECK 


74 112 (-J 


* 


SYSPIKS 


224 340 (-) 
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' nnSTATS Everts 


nnSTATS Events 




linSTBT CHTHLOG INDEX 




linSTAT Event Grouo 0 fnenorv ttanaqenent Events) 




DESCRIPTION 




PAGE 


Event 0 


GROUP 


OF GROUP 






NO. 


EVENT NAtlE: SONSEG 




















DESCRIPTION: ABSENCE TRAP ON CODE/DATA SE GHENT 


0 


ntnORV HRNAGER 






20-1 


CALLING nOOULE: KERHELC 










CALLING PROCEDURE(S): (JUEUEONSEGflENT 




FIEI10RY flANRGER/ CACHING 


20-9 














PARAHETER DESCRIPTION 


2 


nEilORV MANAGER 






20-10 




4 


SCHEDULING 






20-13 


P1,P2 - Segnent Identifier 


6 


FILESVS 






20-16 


P1.(0:4) = Segnent type field 










0 "> Data Segnent 


7 


FILfSYS 






20-25 


1 => SL Segnent 










2 => Progran Segnent 


8 


FILESYS/CACHING 






20-30 


3 => Cache Dnnain 


9 


DISC I/O TRANSFER/CACHING 


20-31 


PI . (4:12) - Progran index into CSTBLK (type 2 only) 


10 


DISC ERRORS 






20-32 


P2 = Segnent Nunber 


11 


SIO 






20-33 


P3 = SLL Pointer (SLL table relative) 


12 


DISC SPRCE 






20-34 


DJ - tJTDTII^ fin o-ta/^L Mjrlforl nf rjllina ftranninal seanetit 


13 


DISC CACHING 






20-51 




14 


CS/3000 






20-36 




15 


CS/3000 






20-40 




16 


CS/3000 






20-43 




19 


DISC CONTROLLER INTRPT 


20-44 




20 


PRIVATE VOLUMES 






20-47 




21 


PROCESS CREATION RHD TERMINATION 


20-48 




22 


HON IT OR CONFIG INFORMATION 


20-49 




23 


TERMINAL I/O 






20-53 
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nnSTOTS Events 



EVENT NAflE: NAKEOC 

DESCRIPTION: HAKE SEGtlENt BN OVERLAY CANDIDATE 
TO THE POOL OF AVAILABLE SPACE 

CALLING nODULE: KERNE LC 
CALLING PROCEDURE: BBKEOC 

PARAHETER DESCRIPTION 

P1.P2 ■ Segnent Identifier 
P1.(0:4) 



RELEASE Sf GHENT 



PI 

P2 



1 Segnent type field 

0 => Data Segnent 

1 => SL Segnent 

2 o Progran Segnent 

3 => Cache Donain 

= Progran index into CST8LK (type 2 only) 
= Segnent Nunber 



P3 
PI 



Bank of region 
Address of region 



P5.P6 - Unused. 



nnSTATS Events 



Event 2 



EVENT NAtlE: SPECIALRQ 

DESCRIPTION: REQUEST OF SEGflENT EXPANSION/CONTRACTION, UNLOCK, 
UNFREEZE, IOUNFREEZE, LOCK, IOFREEZE, FREEZE 

CALLING NODULE: KERNE LC, KERNE LD, ININ 

CALLING PROCEDURES: UNLOCKSEG', IOFREEZE', FETCHSEGNtNT-(KERNELC) 
DLSIZE, ZSIZE, GETPXSEG, ALTDSEGSIZE, 
ALTPXFILESIZE -(KERNELS) 
STACKOVERFLOU -(ININ) 

PARAMETER DESCRIPTION 



G.00.00 
20- 5 



W1STATS Events 



EVENT NRHE: FETCNSEG 

DESCRIPTION: SEGBEHT REQUEST (FOR I/O SYSTEH OR PROCESS) 

CALLING IIODULE: KERNE LC 
CALLING PROCEDURE: FETCHSEWIENT 

PARAHETER DESCRIPTION 



P1.P2 = Segnent Identifier 



P1.P2 = Segnent Identifier 

P1.(0:4) = Segnent type field 

0 => Data Segnent 

1 o SL Segnent 

2 => Progran Segnent 

3 => Cache Oonain 

P1.(4:12) = Progran index into CSTBLK (type 2 only) 

P2 = Segnent Nunber 

P3 = .(0:1) =1 o Request is through FETCHSEWENT 
(types 0,1,2) 
.(12:4) Type of request 
= Oo IOFREEZE 
= 1=> FREEZE 
- 2=> LOCK 
= 3=> IOUNFREEZE 
= 4o UNFREEZE 
= 5o UNLOCK 
= 6=> DLSIZE EXPANSION 
= 7=> DLSIZE CONTRACTION 
= So PXFIXED EXPANSION 
= 9o PXFILE EXPANSION 
= 10o PXFILE CONTRACTION 
= 11o XOS EXPANSION 
= 12=> XDS CONTRACTION 
= 13o ZSIZE EXPANSION 
= Ho ZSIZE CONTRACTION 
" 15=> STACKOVERFLOU 

P4 = For types (P3.(12:4)) 

» 0,2,3,5 o P4.(8:8) = LOCK OR IOFREEZE COUNT 

= 1,4 ■> P4.(0:8) = FREEZE COUNT 

= 6-15 o REQUESTED SIZE OF AREA IN UOROS 

P5.P6 - Unused. 
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PI. (0:4) = Segnent type Field 

0 o Data Segnent 

1 => SL Segnent 

2 o Progran Segnent 

3 o Cache Donain 

P1.(4:12) = Progran index into CSTBLK (type 2 only) 

P2 = Segnent Nunber 



P3 « Requester ID 
.(0:1) = 1 . 

.(0:1) = 0 



.(1:1) ■ 
.(2:1) = 
•(3:1) * 
.(4:1) » 

P4= .(13:3)= 



: > I/O Systen request 

.(1:15) » Ldev » 
o Process request 

.(1:15) = Pin It of requesting process 

«> IOFREEZE REQUEST 
o BLOCKED LOCK REQUEST 
o LOCK REQUEST 
o FREEZE REQUEST 

o Segnent already present 

o Segnent is Recover Overlay Candidate 

=> Segnent already on its way in for soneone 

(Segnent In notion In) 
o Segnent not present — nust fetch 

(Full fetch) 



P5.P6 - Unused. 



"BSTATS Events 



EVENT NAM: SEGIO 

DESCRIPTION: ttEflORY hANAGEHENT READ/URITE OF SEGMENT FR0J1/T0 
DISC QUEUED 

CALLING H00ULE: KERNE LC 

CALLING PROCEDURES: PROCESSINITNSG, STARTSEGURITE 
PARAHETER DESCRIPTION 
P1.P2 ' Segnent Identifier 

PI. (0:4) = Segnent type field 

0 o Data Segnent 

1 o SL Segnent 

2 o Progran Segnent 

3 o Cache Donain 

PI .(4:12) = Progran index into CSTBLK (type 2 only) 

P2 = Segnent Nunber 

P3 = Disc Request Index - (DRQ Table relative) 

W = .(0:1) = 1 o URITE START 
* 0 o READ START 
.(1:15)= Ldev » 

P5.P6 - Unused. 



5.00.05 
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mtSTRTS Events 


nnSTATS Events 


Event 6 


Event 8 «10) 


EVENT NAME: SIOOONE 

DESCRIPTION: HEWRY BANRGEBENT SEGflENT READ /WRITE FROfi/TO DISC 
COMPLETE 

CALLING MODULE: KERNE LC 

CALLING PROCEDURES: SEGRERDCOflPLETOR, SEGURITECOBPLETOR 
PARAMETER DESCRIPTION 


EVENT NAME: SUBPIN 
DESCRIPTION: SURP IN A PROCESS 

CALLING MODULE: KERNELC 
CALLING PROCEDURE: SURPIN 

PARAMETER DESCRIPTION 


P1.P2 = Segnent Identifier 

P1.(0:4) = Segnent type field 

0 => Data Segnent 

1 => SL Segnent 

2 => Progran Segnent 

3 => Cache Donain 

P1 . (4:12) = Progran index into CSTBLK (type 2 only) 
P2 = Segnent Nunber 


P1 = PIN OF PROCESS BEING SUAPPED IN 
P2 = .(0:1) = 0 => BEING SURP 
= 1 => END SURP 
.(1:1) = 0 => NORBAL (PRRTIRL SUAP OK) 

= 1 => SUAP REQUIRED 
.(12:4)= 0 => PROCESS SURPIN COBPLETE 

2 -> NO ROOM, HARD REQ MRY SUCCEED 

3 => NO ROOM, HARD REQ FAILED 

4 => SURPIN STOPPED - BORE URGENT ACTIVITY 

5 => NU LOCK SPACE 

P3 = HflRDREDUEST = TRUE => HARD REQUEST ON SURPIN 
FALSE=> NORMAL 


P3 = Disc Request Index (DRQ Table relative) 
P4 = .(0:1) = 1 => Urite conplete 

= 0 => Read conplete 


P4.P5.P6 - Unused. 


P5.P6 - Unused. 




Event 7 U7) 




EVENT NP.HE: CGARBAGE 

EVENT OESCRIPTIDN: GARBAGE COLLECTION HPS JUST TRKEN PLACE 




CALLING NODULE: KERNELC 

CALLING PROCEDURE: COLLECTGPRBRGE 




PARAMETER DESCRIPTION 




P1 = BANK OF SOURCE JUST ROVED FROB 

P2 = ADDR OF SOURCE JUST tlOVED FROtl 

P3 = HOVEPAGECHT, NUMBER OF PAGES JUST flOVED FROfl 

P4.PS.P6 - Unused. 
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' BHSTRTS Events 


BI1STRTS Events 


MBSTAT Event Group 1 (llenorv Hanaqer) 


Event 14 U16) 


Event 12 (Z14) 

EVENT NAME: ALUOEtl 

DESCRIPTION: FOUND B HOLE FOR R SEGMENT REPLACEMENT REQUEST 


Event Nane: CBCHEBOV 

Description: R cache nove (i.e. logical disc request) has 

just conpleted. 
Calling Bodule: CACHESEG 
Calling Procedure: ProcessCDTLogReqQue 


CALLING nODULE: KERNELC 
CALLING PROCEDURE: RESERVEREGION 


Paraneter Description 


PARAMETER DESCRIPTION 

P1 = REQUESTED SIZE IN PAGES 
P2 = BANK OF SELECTED REGION 
P3 = ADDRESS OF SELECTED REGION 


P1.P2 = Segnent identifier of target DST (LDR'BUFOST) 

P2. (0:1) = 1 then this is a stack. 
P3 = Mapped Donain CDT entry nunber 
P4 = Transfer count 
P5.P6 = Unused 



P4.P5.P6 - Unused. 



Event 13 [ZjSJ 



EVENT NAME: DEALLOCM 

DESCRIPTION: RELEASE REGION OF MEMORY TO AVAILABLE STATUS 

CALLING MODULE: KERNELC 
CALLING PROCEDURE: RELEASEREGION 

PARAMETER DESCRIPTION 



P1 = SIZE RELEASED IN PAGES 
P2 = BANK OF RELEASED REGION BASE 
P3 = fiODRESS OF RELEASED REGION BRSE 
P4.P5.P6 - Unused. 



Event 15 (Z171 



Event Nane: GET_CDT 

Description: Called when an entry in the COT table is 

obtained or released. 
Calling Module: CRCHESEG 

Calling Procedures: Get'CDT'Entry, CDT 'Free 'Entry, 

CDT'Get'MD'Entry, CDT'Rel'MD'Entry 

Parameter Description 



P1 = CDT entry nunber 
P2 = Type of call 

0 = Free entry 

1 = Get entry 

2 = Get Mapped Donain entry 

3 = Release Mapped Donain entry 
P3 = If P2=3 then Ldev Entry nunber 
P4.P5.P6 Not used. 



G.OO.OO 
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MHSTSTS Event! 


MMSTATS Eventt 


Event 16 (120) 


MMSTAT Event Group 2 




Event -20 (-X24) 


Event Nine: QUE.LDR 


r J.p iJ-v'i i ifliicD wnen an uun is qireutro vino t.y i 




Calling Module: CflCHESEG 


EVENT NAME: ALCST8LK 


Calling Procedure: CDT' Queue 'LDR 


DESCRIPTION: REQUEST TO RESERVE fi BLOCK OF ENTRIES IN THE CSTX 


Paraneter Description 


CALLING NODULE: KERNELD 




CALLING PROCEDURE: ALCSTBLOCK 


P1 = Happed Doiiain CDT entry rwnfaer 


PARAMETER DESCRIPTION 


P2 = U)R entry index to be Queued 




P3 = Queue type 




XM - CDT inpeded queue 


P1 =EIX CST BLOCK INDEX ASSIGNED 


XI 3 - CDT active queue 


P2=CSTX DST RELATIVE INDEX OF UORO 0 


P4 P5 P6 Not used. 


flF THF FTR^T RF^FSVFR T^TV FUTRV 




P3=N NUflBER OF CSTX ENTRIES RESERVED 




M,P5,P6 - Unused. 


Event 17 0C21) 




Event Kane: DQUE_LDR 




Description: Called when an LDR is renoved fron the CDT queue. 




Calling Module: CflCHESEG 


Event -21 (Z25) 


Calling Procedure: CDT 'Dequeue' LDR 




cvtm nunc utnLLSiOLr\ 


Paraneter Description 


DESCRIPTION: INDICATES THAT A CST EXTENSION BLOCK HAS BEEN 




DEALLOCATED 


PI = dapped Donain CDT entry nunfaer 


CALLING nOOUL£: KERNELD 


P2 = LDR entry index being renoved fron the queue 


CALLING PROCEDURE: OEALCSTBLOCK 


P3 = Queue type 




Z12 - CDT inpeded queue 


PARAHETERS PARAMETER DESCRIPTION 


%13 - CDT active queue 




P4.P5.P6 Hot used. 


P1-EIX CST BLOCK INDEX ASSIGNED 




TO THE BLOCK OF CST ENTRIES 




P2=CSTX DST RELATIVE INDEX OF UORD 0 




OF THE FIRST CST ENTRY TO BE 


Event 18 (XZ2) 


RELEASED 




P3=HCHT =(#ALLOCRTED CSTX ENTRIES- 




(tEHTRIES BEING RELERSED)«4 


Event Narte: FIND_DE 


P4,P5,P6 - Unused. 


Description: Called uhen need to find an assigned CDT 


Device ent ry , 




Calling nodule: CflCHESEG 




Calling Procedure: CDFFind'DE 




Paraneter Description 




P1 = Ldev nunber of the CDT Device entry to be Found. 




P2 = CDT Device entry 




P3,P4,P5,P6 Not used. 




r. oft (Vi 

O.WfW 




20- 13 




MMSTATS Event! 


HI1STRTS Events 


Event -23 (-127) 


MMSTAT Event Group 4 (Scheduling) 


EVENT NFtnE: RE1.RES0URCES 




DESCRIPTION; RESOURCES (VDS.NAIK HEB0RV, ST EHTRV) RESERVED FOR THE 


Event 40 (X50) 


FOR THE SEGMENT HAVE BEEN RELEASED 


CALLING MODULE: KERNELD 


EVENT NONE: OUIESCE 




DESCRIPTION: PROCESS SUITCH - STATE OF PROCESS SAVED 


CALLING PROCEDURE: RELDATRSEG 






CALLING MODULE: KERNE LC 


PARAMETERS PARAMETER DESCRIPTION 


CALLING PROCEDURE: DSP 


P1=NEU DB DST NUflBER 


PARAMETER DESCRIPTION 


P2=DELTA P HI EXCHBHGEDB CALL 




P3=STATUS RT EXCHHNGEDB CULL 


P1 - PCBOO(CPCB) 


P4,P5,P6 - Unused. 


.(0:1) = 1 => SRR - SCHEDULING ATTENTION REQUIRED 




.(2:1)= 1 => CRIT - PROCESS IS CRITICAL 




.(3:1) = 1 => HSIR - PROCESS HPS SIR 




.(4:1) = 1 => PIOVR - PENDING PI, PROCESS CRITICAL 


MMMSTAT Event C-rouo 3 


.(5:1) = 1 => HSPRI - HOLD SIR PRIORITY 


.(6:1)= 1 => IPEXP - INCORE PROTECT EXPIRED 




.(7:1) =1 => PC - PREEMPT CAPABILITY 


(NOT CURRENTLY ASSIGNED) 


. (8:1) = 1 => MP - MUST PREEMPT 




.(9:1) = 1 => LU - LONG UHIT 




.(10:1)= 1 => SU - SHORT UAIT 




.(11:1)= 1 => TRU - TERMINAL READ UAIT 




.(12:1) =1 => USEOD - USED A QUANTUM SINCE TRANSACTION 




BEGAN 




.(13:1)= 1 => HIPRI - HOLD II1PEDED PRIORITY 




Mi-ii- i Qiinu <:nFT TNTFn D liPT , ; pjfn THruircH tu 




SYSTEM CODE 




.(15:1)= 1 => RITBK - PROCESS IN RIT BREAK 




P2 = PCB04(CPCB) 




. (0:1) = 1 => M - MOURNING UAIT 




.(1:1) = 1 => RG - GLOBAL RIN UAIT 




.(2:1) = 1 => Rl - LOCAL RIN UAIT 




.(3:1) = 1 => MA - HAIL UAIT 




.(4:1) = 1 => BIO - BLOCKED 10 UAIT 




.(5:1) = 1 => 10 - 10 UAIT 




.(6:1)= 1 => UCP - UCOP UAIT, RIT UAIT 




.(7:1) = 1 => JNK - JUNK UAIT 




.(S:1) = 1 => TIM - TIMER UAIT 




.(9:1) = 1 => INT - INTERRUPT UAIT 




.(10:1)= 1 = > SON - SON UAIT 




.(11:1)= 1 => FA - FATHER UAIT 




.(12:1)= 1 = > IMP - PROCESS UAITING TO UNIMPEDED 




.(13:1)= 1 => SIR - PROCESS UAITING FOR SIR 




.(14:1)= 1 => TIM - PROCESS UAITING FOR TIME OUT 




.(15:1)= ' => MEM - PROCESS UAITING FOR "EMOR' 



nnSTfiTS Events 



' PC813(CPCB) 

.(0:1) ■ 

.(1:1) ' 
.(2:1) = 
.(3:1) ' 
.(4:1) * 
.(5:1) = 
.(6:1) " 
.(8:!) = 



P4,P5,P6 - Unused. 



1 => DISPfl - PROCESS 511 DISPATCNING QUEUE 

= > L SCHEDULING CLBSS 
=> C SCHEDULING CLSSS 
-■> D SCHEDUUIHO CLBSS 
=> ! SCHEDULING CLASS 
»> INTER- PROCESS IS INTERACTIVE 
=> CORER- PROCESS IS CORE-RESIDENT 
PROCESS' SCHEDULING PRIORITY 



1HHSTPT Event Group 5 
(SEE CHAPTER t! FOR THESE EVENTS) 



1I1STATS Events 



?1StST Event 5^up a (FILESYS) 
THESE EVENTS ARE FOR DEVELOPflENT USE ONLY RNO PRE NOT NORflRLLY ENABLED 

Event -80(174] 

EVENT NBUE: FOPEN 
DESCRIPTION: OLD FILE OPEN 

CALLING nODULE: FILEACC 

CALLING PROCEDURE: FOPENOB 

PARAMETERS PARAnETER DESCRIPTION 



P1= FILE « 



<0:2)=2 -> NON-SPOOLER ACCESS 
(0:2). HE. 2 -> 



P2= BOPTIONS SEE INTRINSICS nRNURL 

P3= FILE LB8EL FOPTIONS SEE INTRINSICS IWNUAL 

RECORO SIZE 
PS= FILE LABEL SLOCK SIZE 
?6= » OF BUFFERS 



G.00.00 
20- 17 



5.00.00 
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imSTRTS Events 



Event -61(275) 
EVENT NAME: FOPEN' 

DESCRIPTION: OLD FILE OPEN (CONTINUATION OF EVENT -60) 
CALLING nODULE: FILEACC 

CALLING PROCEDURE: FCPENDA 

PARAflETERS PARAdETER DESCRIPTION 
P1= FILE LABEL FILE LIBIT HSU 

P2= FILE LABEL FILE LMIT LSI! 

P3* FILE LABEL • Of EXTENTS 
P4-P6 unused 



W1STATS Events 

Event -6KI7S) 
EVENT NAflE: FOPEN' 

DESCRIPTION: HEii DISC FILE OPEN (COKTIh'UATIOH OF EVENT -SO) 
CALLING 10DULE: FILEACC 

CALLING PROCEDURE: FOPEN 

PflAArtETERS PARAMETER DESCRIPTION 
PI- FCB FILE lmit 

P2= FCB nnx # EXTENTS 

P3= (0:8)= INITIAL ALLOCATION EXTENTS 

P4-P8 unused 



Event -60(174) 

EVENT NAflE: FOPEN 
DESCRIPTION: NEm DISC FILE OPEN 

CALLING nODULE: FILEACC 

CALLING PROCEDURE: FOPEN 

PARAMETERS PARAnETER DESCRIPTION 

Pl= FILE » (0:2)=2 -> NON-SPOOLER ACCESS 

(0:2). NE. 2 -> 
P2= AOPTIONS SEE INTRINSICS RANUAL 

P3= FOPTIONS SEE INTRINSICS HANUAL 

P4= RECORD SIZE 
P5= BLOCK SIZE 
P6= It OF BUFFERS 



O.K. 00 

1Z- '3 



5 .00.00 
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mSTHTS Event! 



t.int -82(176) 

EVENT NSW: FREW 
DESCRIPTION: 

■ CALLING ilflOULE: FILEIO 

CRLUNG PROCEDURE: FREAO 

PSRRnETERS PARABETER DESCRIPTION 
PI' FILE » 



P2= SCatL36 
P3= FLAGS 



TRANSFER COUNT 

(15:1) BuFFer nit Flag 



Event -63U77) 

RENT hAnE: FilRITE 
DESCRIPTION: 

CALLING IIOOULE: FILEIO 

CALLING PROCEOURE: FURITE 

PARAnETERS PBRHHETER DESCRIPTION 

P1 = FILE « 



P2= TCOUNT 
P3= FLAGS 



SEE INTRINSIC IWNURL 
(15:1) BuFfer hit Flij 



G.00.00 
20- 21 



mSTSTS Event! 



Event -65CX101 ] 

EVENT NfiflE: FURITEOIR 
DESCRIPTION: 

CALLING BOOULE: FILEIO 

CALLING BOOULE: FURITEDIR 

PRRQUETERS PARAnETER DESCRIPTION 

P1» FILENUI1 



P2» TCOUNT 
P3= FLAGS 
P4= REC » 
PS* REC • 
P6= NOT USED 



See Intrinsic njnujl 
(15:1) Buffer hit fleg 

nsu 

LSU 



miSTRTS Evintl 

Event -64fI10e) 

EVENT NflrlE: FREAOOIR 
DESCRIPTION: 

CALLING noOULE: FIlEIC 

CALLING PROCEDURE: FREADOIR 

psrs.ietess pfiSSnEtiR ;escr:;t::n 
F1 = file • 



P2= acbtlgg 
P3= FLPGS 
F4. REC » 
P5= SEC I 
NOT USED 



TRANSFER COLNT 

£15:1) Suffer hit flag 

nsu 

LSU 



5.X 50 

:■)- a 



nnSTRTS Events 

Event -66(1102) 

EVENT NAflE: F UPDATE 
DESCRIPTION: 

CALLING H0OULE: FILEIO 

CALLING F'OCEDjAE: c i:?CSTE 

PCSflnETERS PPSAn£:£R DESCRIPTION 

PU FILE • 

P2= TCOUNT See Intrinsic njnuji 

P3= FLAGS (15:1 ) 5-jf'e<- hi: flag 

M-P6 not used 

Event -67IZ103) 

EVENT NRME: iOUfilT 
DESCRIPTION: 

CP LUNG MODULE: FILEIO 

CALLING PROCEOURE: IDUAIT 

PORAIIETERS "R3HETER DESCRIPTION 

P1 = FILE » 



P2= RCBTLOG 
P3= FLAGS 



TRANSFER COUNT 

(15:'! s-jffer hit Fljg 



G.00.00 





(1BST9TS Eventi 


MSiSTS Events 


{vent -S8IZ1M) 

EVENT NRnE: FRERDSEEK 
DESCRIPTION: 




"flS-BT Evtnt Greuo 7 (FILESVS) 
THESE EVENTS SHE FOR DEVELOPMENT USE ONLY AND ARE NOT aCMMUY ENfiBLED 


CALLING HODULE: FILEIO 

CALLING PROCEDURE: FREROSEEK 

PBRAflETERS PBRAHETER DESCRIPTION 




event - 'v i J i ub ) 
EVEUT N3HE: FPOINT 


P1 = FILE li 




CALLING BODULE: FILEIO 


re- rLWI/i (IJIi) OUttir nn flag 




CALLING PROCEDURE: FPOINT 

PBRAnETERS FSRBnETER DESCRIPTIOH 


P3» REC it nsu 




»1> FILE » 


P4= REC a LSU 




PZ= REC » nsu 


PS-PS not used 




P3= LSU LSU 


Event -69 (1105) 




P4-PS not used 


EVENT NOTE: FSPBCE 
DESCRIPTION: 




Event -71 (Z107) 


CALLING nODULE: FILEIO 

CALLING PROCEDURE: FSPRCE 

PRRfinETERS PBRBI1ETER DESCRIPTIOH 
P1 = FILE » 




EVENT NfldE: FCCNTROL 

UCSlKir 1 1UN. 

LnT_i.i~lj PUUULC. rILtiU 

CULLING PROCEDURE: FCONTSOL 

PARAMETERS 5BRBHETER DESCRIPTION 


P2= DISPLACES?.*! SEE INTRINSIC BflHUM. 




P1= FILE » 


P3-P6 not used 




?2= CODE See Intrinsics nanual 
P3-P6 not used 


5.00.00 
20- 25 




G.00.00 
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nilSTflTS Events 


nRSTRTS Events 


Event -7? (Z110) 




C„„,4 _7C fTIIT^ 


EVENT NRnE: FSETHODE 
DESCRIPTION: 




EVENT NBBE: FGETINFO 


CALLING nODULE: FILEIO 




CALLING nODULE: FILEIO 


CALLING PROCEDURE: FSETHGDE 




CALLING PROCEDURE: FGETINFO 


PRRfinETERS PBRAI1ETER DESCRIPTIOH 




PBRBHETERS PBRBHETER DESCRIPTION 


i PI- FILE • 




P1= FILE » 


P2= fIDDEF Lfi&S SEE INTRINSIC tlflNUAl 




P2= FOPTIONS SEE INTRINSIC nflNURL 


P3-P6 not used 




P3= BOPTIONS SEE INTRINSIC nflNUBL 


Event -74 f 11 12^ 




P4-P6 not used 


EVENT HArtE: FCHECK 
DESCRIPTIOH: 

CAlLING fTGuULc: nLciu 




Fuant -7(5 f?114l 
event *0 I A 1 1 "* J 

EVENT NBBE: FRE AO LABEL 

DESCRIPTION: 


CALLING PROCEDURE: FCHECK 




CALLING nODULE: FILEIO 


PRRRHETERS PRRRnETER DESCRIPTION 




CALLING PROCEDURE: 


P1 = FILE « 




PARAMETERS PBRBflETER DESCRIPTION 


P2= ESRCRCODE SEE INTRINSIC BRNUBL 




Pt= FILE t 


P3-P6 not used 




PZ= TCOUHT SEE INTRINSIC MANUAL 
P3-P6 unused 


i 

i 

1 5.00.00 

20- 2' 




5.00.00 
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IfflSWTS Cvlfttl 



Event -77 (mi) 

EVENT NflnE: FliRITELBKL 
DESCRIPTION: 

CALLING MODULE: FltEIO 

CALLING PROCEOORE : FURITELBBEL 

PARAMETERS PARAMETER SiSBIfIX 

PI" FILE II 

P2" TCOWT SEE INTRINSIC TSNUNL 
P3-P6 urysed 

Event -73 (1116) 

EVENT NAME: FLOCK 
DESCRIPTION: 

CALLING MODULE: FltEIO 

CBLLING PiOlEDURE: FLOCK 

PBRAMETE"; PARAMETER DESCRIPTION 

r1 = FILE • 

P2= LOCKCONO See Intrinsic* nanual 
P3> CONO CODE " " " 



PIMSTATS Events 

Ev.nl -71 HUH 

EVENT N8BE: FUNLOCK 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FUNLOCK 

PARAMETERS PSRPrE'ER SESCRIPTISN 
PI" FILE » 



P2-PS 



unused 



6.00.00 
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WITS Events 



MMSfAT Event Group 8 

Event -80 (Z120) 

EVENT NAME: FRENAME 
DESCRIPTION: 

CPLLlhG MODULE: FILEACC 

CALLING PROCEDURE: FRENHHE 

PARAMETERS PARAMETER DESCRIPTION 

P1= FILE » 



P2-P6 



unused 



nnSTPJS Events 



Event 83 OM231 
Event Njne: STRflTEGV 

Description: Called to deternine tre type of strategy used 

based on uho the caller of CDT'A'TACHIO is. 
Calling nodule: CBCtfSfG 
Calling Procedure: COT'STPSTEGV 

Paraneter Description 



P1 
P2 
P3 



■ COT Maoped Ccr*am entry 

■ LDR entry index 

■ Strategy 



Fvunt -81 <t121) 

EVENT NAME: FCLOSE 
DESCRIPTION: 

CALLING MODULE: FILEBCC 

CALLING PROCEDURE: FCLOSE 

PPRBnETERS PARAMETER DESCRIPTION 

"I- FILE « 

P2= OISP See Intrinsic nanual 

P3= SECCOOE 

rfl-Pfi unused 



0 - Orknoun caller 

1 - Unknc-un fron File Systen 

2 - Spooler 

3 - Directory 
4-7 - Unknown 

8 - Ge-nessagt 

9 - File Systen, Ouiesce I/O 

10 - File Systen, sequential, N08UF 

11 - File Systen, direct, NOBUF 

12 - File Systen, sequential, BUF 

13 - File Systen, direct, BUF 

14 - File Systen, KSAM 

15 - File Systen, lnP.CE 
P4.P5-P6 Not used. 



G.OO.OO 
20 31 



3.00.00 
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Fill J IfllO t*inT.al 


HHSTHTS Events 


Evint M KIM) 




Event 31 (1130) 


Event *ane: INITIATE 

Description: Called uhen itarting/conpltting logical disc 

rail i mm Nnrtti 1 • • rai*Hf ?Cfi 

waning ncouier Lntriwcv 

Calling Procedures: CDT "Initiator, COT'Cartplttor 




Event Nane: UN_nBP_fiG 

Description: Called uhen disc donain no longer napped, (i.e. both 
the logical and physical I/O it complete). 

''all ins Hnrful» - rfirHFSFfl 
u ill 1 in^ LTOOUlff • u>ni,nt 31.17 

Calling Procedure: CDT' flflp' CACHED' REGION 


Paraneter Description 




Paraneter Description 


PI * COT Happed Oonain entry nunoer 
P2 = LDR entry index 
P3 » type 

0 s Initiator 

1 - Conplctor 
P4.PS.P6 Hot used. 




P1 = CDT Ldev entry nunber 
P2 = Region CDT entry nunber 
P3,P4,P5,P6 Not used. 

Event S3 (1131) 


Event S6 fXIZS) 

Event Kane: COT ATT 

Description: Called fron COT'HTTBCHIO. 

CalUng nodule: CS1CHESEG 

Calling Procedure: CDT'Bttachio 




Event Nane: LINK_RE& 

Description: Called uhen a disc donain gets linked into the 

linked list of donaine For an ldev. 
Calling nodule: CflCHESEG 

Calling Procedure: LINK 'CACHED 'REGION, UNLINK 'CACHED' REGION 
Paraneter Description 


Paraneter Description 

P1 = Ldev 
P2 - Function 
P3 * Flags 
P4.P5 - Parnl, Pam2 
PS = Count 




PI = Type 

0 - Link 

1 » Unlink 

P2.P3 = Address of region base 

P4 - CDT entry nunber found in the header 

P5 = * of pages 

PS Not used. 


Event «? (31127) 






Event fane: flflP_D0H 

Description: Called when need to "nap" a disc donain. 

tailing noame. cl^cjlv/ 

Calling Procedure: COT'nAP'CACHED'DOIIAIN 






Paraneter Description 






PI = h«m COT entry nunber 
P2 = Returned COT entry 
P3,P4,PS,P6 Hot used. 






G.00.00 
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G.00.00 
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• 


nnSTflTS Events 


nHSTATS Events 


tltlSTRT Event Group 9 f Disc I/O Reouests) 




nnSTAT Event Group 10 


Event 90 (Z132) 




Event 100 [1144) 


Event Sane: REQCACHE 

Description: Called to see if caching uili accept this 

I/O request. 
Calling nodule: CflCHESEG 
Calling Procedure: 8E0.UESrCP.CHE 




EVENT NBUE: DISK ERROR 
DESCRIPTION: RECORD DISC ERROR 

CALLING tlOOULE: I0FDISC1 

CALLING PROCEDURE: FHDDVR 


Paraneter Description 




PARAMETERS PARAHETER DESCRIPTION 


P1 = LDR entry index 
P2,P3,P4,P5.P6 Not used. 




P1=0IPT(DSTRT) HAROUARE STATUS 
P2=S0 gnisc 
P3=I00P(QL0EV).qLD£VN LOR STOCOUKTSLSL(S) ) 
=U>EV/SIO PROORAn COUNTER 

Event 101 (1145) 


Event -9» (Z142) 

EVENT HARE: DISK TRAFFIC 

DESCRIPTION: DISC I/O REOUEST HAS SEEN QUEUED 




EVENT HAHE: DISK ERROR 
DESCRIPTION: RECGRO DISC ERROR 

CALLING MODULE: IOWISCO 


CALLING IBDULE: rBWORES 




CALLING PROCEDURE: MHOOVR 


CALLING PROCEDURE: ATTACHSO 




PflRAnETERS PARAMETER DESCRIPTION 


PARflflETERS PRRRHETER DESCRIPTION 

P1=CHT DATA TRANSFER COUNT: UQROS IF >0; 

BYTES IF <0 
P2=FLAGS.(0:4) 
P3=FNCT =0 ~>REAO 

=1 ==>URITE 

=2 ==>OPEN FILE 

=3 ==>CL0SE FILE 

M ==>CLOSE DEVICE 


P1*DIPT(0STAT) HARDUARE STATUS 
P2=S0 anise 
P3=IOOP(QLDEV).0LDEVN LOR STOC0UHTiLSL(8)) 
"LDWSIO PROGRFM COUNTER 


'• 0.00.00 

JO- 3S 




0.00.00 
20- 36 



WSTBTS Events 


Hfl5TRT3 Events | 

i 


BBSTRT Event Group 11 


} 

"hS'AT E^ert •rr.e 'Z 


Event -110 CI15S) 


Event 120 (1170) i 


EVENT NUDE: STRUT I/O 

OeSCHIPTIOHiDRIVEII INITIATOR FOR SIO DEVICE HAS BEEN CALLED 


EVENT NABE: SOf'OERTH 1 
DESCRIPTION: BUG CATCHER 1 


CALLING BODULE: HfiRDRES 


CALLING nODULE: 4SRDRES 


CALLING PROCEDURE: SIODF! 


CALLING PROCEDURE: SOFT ' DEATH 


PARRBETERS PBRBBETER DESCRIPTION. 


PASAtlETERS PARABETER DESCRIPTION 


P1=I0C#L(QSTP.T) LOR IOOPl(OLOEV). LDEVN 
=(0:S) PCS ENTRY • Of PROCESS BAKING REQUEST 
(!:S) LOGICAL OEVICE NUB8ER Of DEVICE fOR I/O 
P2=IC0P(0ueCT)>U0RD COUNT IF>0;SYTE COUNT lf<0 
P3=(0:2) = fUHCTIOM COOE SPECIflEO BY DRIVER 


PI SOFT' DEATH I.D. N0B8EA j 
?2 CALLERS STATUS REGISTER 

P3 CALLERS DELTA ? 1 

1 

1 


' 0 => READ 
= 1 -> URITE 
■ ! => CONTROL 


Event 125 (1175) 


=(6:10)' DSTN Of TARGET DATA SEO 

Event -111 (1157) 

EVENT NRUE: I/O COnPLETIOM 
DESCRIPTION: SIO COnPLETIOM 


EVENT NABE: IOBUFTRP 

EVENT DESCRIPTION: IOSVSTEB BUFFER TRAP 

CALLING BOCULE: HARDSE3 
CALLING PROCEDURE: SIODB 

PARflflETER DESCRIPTION 


CALLING BOOULE: HARDRES 

CALLING PROCEDURE: SIOOO 


P1 = IOQP 

P2 = IOOP(aOSTN).DSTN = OST NUBBER OF BUFFER 
P3 = 0 


PARAHETERS PRRHBETER DESCRIPTION 


I 


P1=IO0P(0LDEV).Lj)Fv , N-L0GICAL DEVICE RUBBER Of 
DISC IHVOLVEO IH TRANSFER 
P2'IO0P(0PflR1) (DEFINED BY DRIVER) 
P3=ILW(QPAR2) (DEFINED BY DRIVER) 


i 

i 

1 
l 


0.00. 00 
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nnsTRTS Events 


BflSTATS Events 1 


BBSTRT Event Group 13 


1 

BBSTRT Event Gtuo 14 (CS/3000) 


Event 139 (1213) 


Event MO (1214) 


Event Raw: CJ6SENT 

Description: Either the nipped due donam ar the target 

DST uas absent uhen * cache nove uas attempted. 
Calling Bodule: CACHESEG 
tilling Procedure: PROCESSCOTLOGREQOUEUE 

Paraneter Description 


EVENT NABE: COPEN ; 
nFSCRTP T ION: 

CALLING BOOULE: CSBSYS2 

CALLING PROCEDURE: COPEN 

=;asnE r ERS =SRfi»E T ER 3ESCRIPII3N 


PI =0 Clapped Donein absent 

P3.P4 * Segnent identifier of Rapped Dentin 
PS.P6 Not ueed. 


PI (0:B) = CS ERROR CODE 

(8:S) = LOGICAL DEVICE -LB8ER 

P2 PBRP1 


PI » LOR entry index (DST not present) 
Vt - Pin 

P3,M « Segnent identifier of DST (PR. (0:1) * 1 stack) 
PS, PS Hot used. 


P3 PBAP2 


] 
i 

O.OO.OO 
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mmstrts Evinti 



MMST9TS E»entJ 



Ev«nt 14? t«1H 

EVENT NAME: CSBCRTIO 
DESCRIPTION: 

CBLLZME MODULE: "MSYS1 

CALLING PROCEDURE: CABORTIO 

PSRSMETERS PARAMETER DESCRIPTION 

PI LOGICAL DEVICE 

P2 IOSIN0EX 

P3 0 



Event 144 (1220) 

EVENT NAME: CSIOUSIT 
DESCRIPTION: 

CULLING MOULE: C0MSYS1 

CALLING PROCEDURE: [SIOUAIT 

PARAMETERS PPRflnETER DESCRIPTION 

PI fO:3) = CS ERROR IGOE 

(8:8) » LOGICAL DEVICE NUMBER 

P2 TRANSMISSION LOG 

P3 



Event H6 (2222) 

EVENT NAME: CCLOSE 
DESCRIPTION: 

CRlUNG MDULE: COMSYS3 

CALLING PROCEDURE: CCLGSE 

PHRSnETERS PBRBnETER OESCRIPTIOH 

Pi (C:S) • CS ERROR CODE 

!8:8) = LOGICAL DEVICE NUMBER 

P2 LIhE NUMBER 

?3 0 



G.OO.OO 
20- 41 



MMSTflTS Events 

Event 147 »223i 

EVENT NSI1E: CREAO 
DESCRIPTION: 

CBlUNG MODULE: C0MSYS4 

CALLING PROCEDURE: CREflO 

PARAMETERS PARAMETER DESCRIPTION 

P1 (0:5) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 INCOIWT 

P3 STATION 

Event 149 (1225) 

EVENT NAnC: CtiHTE 
DESCRIPTION: 

CALLING nOOULE: C0iiSYS4 

CALLING PROCEDURE: CUSITE 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 OUTCOUNT 
P3 INCOUNT 



! 
i 

i 

G.OO.OO 
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MMSTAT Event Group 15 (CS/3000) 



Event 150 U22S) 



EVENT NAME: CSDRIVER 
DESCRIPTION: 

CALLING MODULE: 3SCLCM 

CALLING PRCCED11RE: CSORWER 

PSBSnETERS PARAMETER DESCRIPTION 

PI TIMER LSI! 

P2 CURRENTSTRTE .WERE THE DRIVER IS IN THE 
STATE TRANSITION TABLE 

P3 CURRENTEVENT (0:8) = CURRENT EVENT 
!!:8) = LOGICAL DEVICE 
LHBT CAUSED THE DRIVER TO BECOME 
ACTIVE 



Event 152 (1230) 



EVENT NAME: CCOHTSOL 
DESCRIPTION 



CALLING MODULE: COBSYSS 

CALLING PROCEDURE: CCDNTROL 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 CONTROL CODE 

P3 PARAMETER 
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SBSTRTS Evtntl 



nnsTBTS Eventt 



Event 153 iZ231) 

EVEHT *RBE: C5PENTRRCEFILE 
DESCRIPTION: 

CALLING nootiiE: 

CALLING PROCEDURE: COPENTRACEFILE 

PARRBETERS PBRBBETER DESCRIPTION 

PI (0:1) " CS ERROR CODE 

(!:!) = LOGICAL DEVICE NUBBER 

P2 CTRBCEINFO 

P3 0 



E..nt 155 (11)2) 

EVENT KOBE: CPOLUST 
DESCRIPTION: 

CALLING BCOULE: 

CALLING PROCEDURE: CPOLUST 

PARBBETERS P9RRBETER DESCRIPTION 

PI LOGICAL DEVICE 

P2 CS ERROR CODE 
P3 PBBP 



Event 154 (Z232) 

EVENT NBBE: CCLOSETRBCEFILE 
DESCRIPTION: 

CALLING BQOULE: 

CALLING PROCEDURE: CCLOSETRACEFILE 

PARRBETERS FARABETER DESCRIPTION 

P1 (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUBBER 

P2 0 

P3 0 
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BBSTRTS Eventj 



TSTPTS Evente 



BBSTBI Event Group 16 



Event 160 tZ240) 



EVENT NflnE: CREAD 
DESCRIPTION: 



CFILLIHG BODULE: DSBOH 
CALLING PROCEDURE: 



=BAfiBET£SS PBRAnETER DESCRIPTION 

P1 = TII1E STBBP 

P2= (0:4) NOT USED 
(4:1) BLOCK 
(5:2) STATE 
(7:3) NEXT 

(10:1) :*0 INITIALIZATION EVENT 

:=1 COBPLETION EVENT 
(11:5) SUB EVENT NUBBER 

P3= DEPENDS ON THE SUB EVENT NUBBER BHD 

IF IT IS AN INITIALIZATION OR COBPLETION EVENT. 
BSG: (0:4) STRNTYPX 

(4:6) BSG CLS 

(10:16) STRHTVP 



BHSTPT Event Group 19 



Event 191 (Z277) 

EVENT HRflE : DISKINTRPT 

DESCRIPTION: A 7905/7920 CONTROLLER IS PROCESSUS 3N ATTENTION INTERRUPT 
; ONLINE/OFF LINE) 
CALLING BOOULE: HARORES 

CALLING PROCEDURE: SIODH 



PBUPBETERS 
P1= WITP 



PARAMETER DESCRIPTION 

(US)-l.e. UHO GOT THE INTERRUPT 



P2* SDITP (THEB)--i.e. UHO RAN THE POLL PROGRNH 

P3* DITP "OUR" OIT FLAGS UORD 

THERE SHOULD BE RT LEAST AN Z300 BHD AN Z303 FOR EACH SIO PRGH. 
A SINGLE ISOLATEO (IN TIBE) REQUEST UILL GENERATE AT .EAST A 
1303, 1300, 1303. IF THE QUEUE Of IDQ'S ON A DU NEVER EBPTIES, 
THERE uOULO BE ONE Z300 AND ONE J303 PER SIO PRC*. 



SUB 


SUB EVENT 


INIT 


conp 


EVENT NO. 


NBBE 


phru 


PARK 


0 


CREAD 


0 


LEH 


1 


CURITE 


x nsG 


LEH 


2 


IOUAIT 


0 


LEH 


3 


CCHECN 


0 


ERRCOD 


4 


DSBTTN 


0 


0 


5 


osuc 


X BSG 


R BSG 


6 


CHNGEUHIT 


PBRB 


0 


7 


nONREO 


RED 


0 


10 


CABORT 


0 


Uf 


11 


CRESET 


0 


0 


12 


C3DBTB 


R BSG 




13 


CS'ESEBO 
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BBSTATS Evente 


BBSTRTS Event* 


Event 192 (J30O) 


Event 193 (1301) 


EVENT KB*: GIPINTERRUPT 

DESCRIPTION: INTERRUPT JUST PROCESSED 


EVENT N3BS: STRRTIO 

DESCRIPTION: Issuing SIQP -acrine instruction. 


CALLING BODULE: HARDRES 


CALLING HGDULE: nP.SORES 


CP.tlT.NG PROCEDURE: HP 


CALLING PROCEDURE: START'HPIB, STRRTIO ' 


PARAMETERS PARAMETER DESCRIPTION 


PARAMETERS PSRSBESER DESCRIPTION 


?1 = LDEV 


PI = ^csciata aia-sss cf SIC ^rcgrjn to start. 


P2 - flUEUE ELEBENT UORD ENTRY INDEX 


P2 = LDEV nL-ce^ 


PS ' CONTENTS OF DIT UCRO 0: THE FLAGS JCRO 


P3 = r, ,.?er 

P4 = 3' entry' index ;s:n c;:=(dics?) 


M = CHANNEL PR0CRPJ1 INSTRUCTION POINTER 


PS = DIT UORD 0: THE DIT FJliS .'.10 


PS = CONTROLLER STATUS 


ps « lsu of a mm frw a am to nt* 


Pi = LSU of a Return fnjn TIBER 
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BBSTATS Events 


I1I1STATS Events 


Event 194 (X302) 


BBSTAT Event C-rojo ?0 


EVENT NABE: SI3DH-EHTRY 
DESCRIPTION: Entering SIODn 


THESE EVENTS a«E FOR DEVELOPBEHT JSE wu .WO ARC SOT HNU! ENASiEO 


CALLING rfOOU L£ : HfiRORES 


Event 200 (Z310) 


CALLING PROCEDURE: SlOOtt 

PARAflETERS PARAnETER DESCRIPTION 


EVENT NME; DISKBUSCSTCriER 

DESCRIPTION: A BOUNTED VOLUBE TB8LE CHANGE IS BEING BADE. 


P1 - LDEV 


CALLING flODULE: PVSYS 


P2 = 100 OR DM table relative index 


CALLING PROCEDURE: BVTABLE 

PARRRETERS PSR3BETER DESCRIPTION 


P3 = DIT UORD 0 (DIT FLAGS) 

P4 = CURRENT STATE OF THE VARIABLE STATE 
IN SIOOB 

PS = UNUSED BT THIS TME 


P1= FUNCT 

0 = DELETE ENTRY 

t = aoo ENTRY 

2 = PRESERVE ENTRY 

'2= nv;am ;«-:unted velube rmi imoek) 


P6 = LSU RETURNED 8Y CALL TO TIBER 


P3= DELTAP (VALUE OF Q-2) 

Event 201 (Z311) 


Event 195 (ZX3) 

EVENT NABE: SIOWl-EXIT 

DESCRIPTION: Leaving SIODd nain loop. 


EVENT NfiJIE: DISKBUGCRTCHER 

DESCRIPTION: A PRIVATE VOLUBE USER TRBlE CmAN&E IS 3£I-j --TE. 
CALLING BCDULE: PVSYS 


CP. LUNG nODULE: HARDRES 


CALLING FROCEDURE: USERTSBLE 


CALLING PROCEDURE: SIODH 


PSRanETESS PHRBBETER DESCRIPTION 


PARAMETERS PASAflETER DESCRIPTION 

SflBE AS EVENT 194 (1302) 
EXCEPT THAT EVENT IS 195 (Z303) 

\ 

i 


P1= FUNCT 

0 = CREATE USER ENTRY 

1 = SENABE USER ENTRY 

2 = R£ T1 JRN PL- rv'fiax TNDT';" '.'tt* : J - 

SPECIFIC PCS 

3 ■ SE'iJRN «u PCB POINTERS 'jSIn'T- A SPECIFIC 

nVTABX 

4 = GET USER ENTRY 

P2= wmt (CRATED VSuftt T=.3.£ In;en) 
P3* CELTAP (VALUE OF 3-2) 
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BnSISTS Event 



nnSTRIS Eventi 



BBSTRT Event Craua Zl Pntm Cft»li»n» irt 
Ttr»ur,iUont Logical Pnietsi Tiblt 

Event -211 (Z3231 

EVENT NABC: PROCESS COBPLETION 
DESCRIPTION: PROCESS HAS TERBIRRTEO 

CALLING BOOULE: BORGUE 

CALLING PROCEDURE: TERNIHATE 

PARAMETERS PARBBETER DESCRIPTION 

P1-0 
P2=0 
P3=0 



0.00.00 
20- S3 



BBSTRT Event Grain 22 
Ting Stinp Evtnt Trice £"»Plt 3ui&it 

Event 221 *n35! 

EVENT HflnE: CONFIGURATION INFORMATION 
DESCRIPTION: EVENT CROUP BBSK 

CRLUNO BOOULE: CRIO 

CALLING PROCEDURE: CONSBON 

PARAnETERS PARBBETER DESCRIPTION 

P1- BEASBSKO 

P2= BEASnSKI 

P3*Reserved 
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nnSTRTS Evtnti 



Event 222 (1336) 

EVENT NHRE: CONFIGURATION INFORRBTION 
DESCRIPTION: RPE VERSION FIX UPDATE 

LULLING MODULE: OPCOBBBNO 

COLLING PROCEDURE: CXBON 

PARAMETERS PARBBETER DESCRIPTION 

P1= VERSION 

P2" FIKL 

P3= UPDATEL 



Event -223 (-»37) 

EVENT NflHE: CONFIGURATION INFORMATION 

DESCRIPTION: SVSTEB TABLE LOCATIONS AND AVAILABLE LINKED BEBORY 
IHFORBBTION 
CALLING BOOULE: OPCOBBBNO 

CALLING PROCEDURE: CXBON 

PARABETERS PRRAflETER DESCRIPTION 

P1-F (Z1032J=«CST(0HDST(0) 

=DISPLBCEBENT TO COOE 

P2=F(X1033)=«CST(LRST)-MST(0) 

=OISPLBCEHENT TO SHARPS LE 

P3=LOGICRL(T0TALMlSK(4))=LIK<E0 BEBORY SIZE 



BBSTATS Eventi 



Event -224 -(1340) 

EVEHT NABE: SYSPINS 

DESCRIPTION: LOGICAL PROCESS TABLE 

CALLING BOOULE: OPCOBBBNO 

CALLING PROCEDURE: CXBON 

PBRBBETERS PPRSBETER DESCRIPTION 

P1*BBSOLUTE(ZU41)=PR0GEH'S PCBENTRY WISER 
P2=BBS0LUTE(Z1142)=Bflfl'S PCB ENTRY NUMBER 
P3=BBSOLUTE(Z1143)=UCOP'S PCB ENTRY NUB8ER 



Event -225 (-Z341) 



EVENT NBBE: SYSPINS(CNTD. ) 
DESCRIPTION: LOGICBL PROCESS TABLE 



CALLING BOOULE: OPCOBBBNO 
CALLING PROCEDURE: CXBON 



PPRRBETER DESCRIPTION 
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P1>ABS0LUTE(Z1144)=PFAIL'S PCB ENTRY MUflBER 
P2=R6S0LUTE{Ztl45;=DEVREC'S PCB ENTRY • 
P3=RBS0LUTE(Zt146)=PRBSG , S PCS ENTRY « 



Event -226 (-Z342) 

EVENT NRBE: SYSPINS(CNTO. ) 
DESCRIPTION: LOGICAL PROCESS TSBLE 

CALLING BOOULE: OPCOBBBNO 

CBLLIVC PROCEDURE: CXBON 

PARAMETERS PBRBBETER DESCRIPTION 

PI 'ABSOLUTE (XI 147 )-STMSG'S PCB ENTRY • 
P2*ABSOLUTE(Z"5O)=L0G , S PCB ENTRY » 
P3'RBS0LUTE!Z1!51)>L0P,0'S PC! ENTRY » 



GOO.OO 



nnSTHTS Events 



Event -227 (-Z343) 

EVENT NHBE: SYSPINS(CNTD-) 
DESCRIPTION: LOGICAL PROCESS TABLE 

CALLING BODULE: OPCGBBBND 

CALLING PROCEDURE: CXBON 

PARABETERS PBRABETER DESCRIPTION 

P1=BBS0LUTE(Z1152)=I0BESSPR0C'S PCB ENTRY It 
P2=fl8S0LUTEC%1153)=SVSI0PR0C'S PCB ENTRY « 
P3=flBS0LUTE(Z1154)=nEBL0GP'S PCB ENTRY It 



Event -228 (Z344) 

EVENT NAtlE: TIflESTBflP 
DESCRIPTION: TIBESTABP 

CALLING BODULE: OPCOBBBND 

CALLING PROCEDURE: CXBON 

PflRHtlETERS PBRABETER DESCRIPTION 



PI CALENDAR (0; 

(7: 

P2=CLOCK(UORD1).(0: 
(8: 

P3<L9CK(U0R02).(O: 
.(8: 



7)=YERR OF CENTURY 
9)=DBY OF YEAR 
7 HOUR OF DAY 
8HINUTE OF HOUR 

7) =SEC0NDS INTO BIHUTE 

8) =TENTHS OF SECONDS 



BBSTRTS Events 



Event 230 [2346) 



nnSTBT Event Group 23 tTerninal I/O) 



EVENT NBBE: TERBREBD 

DESCRIPTION: TERBINAL READ COBPLETION 



CALLING MODULE: HBRDRES 
CALLING PROCEDURE: TIP 



PBRABETER DESCRIPTION 



P1 - LDEV 

P2 - READ DURATION 
P3 = BYTES READ 



Event 231 (Z347) 



EVENT NABE: DC1DC2RCK 

DESCRIPTION: DC1/DC2 HAS BEEN SATISFIED 

CALLING BODULE: HBRDRES 
CALLING PROCEDURE: TIP 

PBRABETERS PBRABETER DESCRIPTION 

P1 = LDEV 

P2 = DURATION (BETUEEN START AND DC2) 
P3 = BYTES READ (EXCLUDING DC2) 



Event -229 C-Z34S) 



EVENT NABE: BONOFF 
DESCRIPTION: END EVENT TRACING 

CALLING BODULE: OPCOBBRND 

CALLING PROCEDURE: CXBON 

PBRABETERS PBRABETER DESCRIPTION 

P1=0 
P2=0 
P3=0 
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BBSTBTS Events 
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nBSTBTS Events 



Event 234 (Z352) 



Event 232 (Z350) 



EVENT NfitlE: TERBURITE 
DESCRIPTION: URITE COBPLETION 



CALLING BODULE: IOTERBO 
CALLING PROCEDURE: TERBIOB 



PARABETER DESCRIPTION 



P1 = LDEV 
P2 = 0 

P3 = BYTE COUNT OF TRANSFER 



Event 233 (Z351) 



EVENT NABE: BINREAD 

DESCRIPTION: BINARY RERD COBPLETED 



CALLING BODULE: HBRDRES 
CALLING PROCEDURE: TIP 



PBRABETERS 
P1 - LDEV 
P2 = DURATION 
P3 = BYTES REBO 



PBRABETER DESCRIPTION 



EVENT NBBE: TERB LOGON 

DESCRIPTION: TERBINBL JUST LOGGING ON 



CALLING BODULE: IOTERBO 
CALLING PROCEDURE: TERBIOB 



PARAMETERS 
P1 = LDEV 
P2 = 0 
P3 = 0 



Event 235 (Z353) 



PARABETER DESCRIPTION 



EVENT NABE: TERB LOGOFF 

DESCRIPTION: TERBINAL JUST LOGGED OFF 



CALLING BODULE: IOTERBO 
CALLING PROCEDURE: TERBIOB 



PBRABETERS 
PI = LDEV 
P2 = 0 
P3 = 0 



PBRABETER DESCRIPTION 
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BMSTATS Event! 



Event 236 (1391) 



EVENT NAME: 
DESCRIPTION: 



SPECCHAR 

PROCESSED SPECIAL CHP.RRCTER 



tfflSTRIS Events 



Event 240 (Z360) 



IW1STHT Event Croup 24 (Pouer Fail) 



CALLING MOOULE: HflRDRES 
CALLING PROCEDURE: TIP 



PARAMETER DESCRIPTION 



PARAMETERS 
PI = IDEV 
P2 = SPECIAL CHARACTER PROCESSED 
P3 = 0 



Event 237 (Z365) 



EVENT NAME: BREAK 
DESCRIPTION: PROCESSED BREAK 



CULLING MODULE: HRRDRES 
CALLING PROCEDURE: TIP 



PARAHETERS 
P1 = LDEV 
P2 = DSTRTE 
P3 = 0 



PRRRtlETER DESCRIPTION 



Event Nane: PFRIL 

Description: Power fail detected. 

Calling nodule: WIN, PFAIL 

Calling Procedures: Pouerup (ININ), Pouerup (PFAIL) 
Paraneter Description 



P1 = 0 Called fron Pouerup in ININ 

1 Called Fron entry in Pouerup in PFRIL 

2 Called Fron end of Pouerup in PFAIL 

P2 = For P1=0 this is 0 
For P1M.2: 

TRUE = Multiple pouerfail 
FALSE 1 First pouerfail 



P3 = 



= No pouerfail or PFAIL processing conplete 

= Set by the pouer doun trap in ININ 

= Set by the pouer up trap in ININ 

= Set uhen auake the PFRIL process 

~ Set by PFAIL after nessage appears on console 



■ SVSUP 

0 - Systert not bach up after pouerfail 

1 = Systen back up after pouerfail 



P5.P6 not used. 



Event 238 B3 S6) 



EVENT NRTTE; SPECREAD 

DESCRIPTION; SPECIAL READ TERMINATION CHARACTER DETECTED 

CALLING nODULE: HRRDRES 
CALLING PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 

P1 = LDEV 
P2 = DURATION 
P3 = BCNT 
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General Rootfile Layout 



General Rootfile Layout 



CHAPTER 21 ROOTFILE LAYOUT 
General Rootfile Layout 



I 

LRBEL 0 I RDOTFILE INF0RHRTION 

I 1 28_uds 



1 | PASSUORD TABLE 
I 



2 | PBSSUORD TABLE (COKT. ) 
I 



3 | ITEfl R/U TABLE 



L 



SET R/U TABLE 



RECORD 0 | DATABASE GLDBRL INFO 

I 128 uds 



1 | ITEtl TABLE 

. j (variable size) 

. | 

. | SET TABLE 

. I (variable size) 

. I 

. | DATA SET CONTROL BLOCKS 

. I 

. | (DSCB) 

. I 

. | (variable size) 

. I 



The data base ROOT FILE is an I1PE file uith fileccde equal to -400. 
The record size is 128 uords, fixed, binary fomat uith a blocking 
factor of 1. The size of the file depends on the nunber of data itens 
and data sets defined in the data base. 
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Root File Label 0 



UORD 0 
1 
2 
3 
4 
5 
6 
7 



RL' CONDITION 


_(rootfile_condition) : 


RL'DATE 


(creation~date) 


RL'TIIIE 


(creation tine) 


RL'EVEROPEN 


RL'COLDLOADID 


(cold load id) 


RL'USERCOUNT 




RL'DBCBDSTHUH 


_(DST_nunber_of_DBCB) 


RL' LOGID 


(log id for 




transaction logging) 


RL'LOGPBSS 


(log id passuord) 


RL' FLAGS 


(database flaqs) 


RL'STORDATE 


(DBSTORE date) 


"RL'STORTlnE 


(DBSTORE tine) 


RL'BUFSPECCOUNT (buffer spec count) 
"RL'ILRCREATEDBTE (date ILR logj:reatedT 


~RL' ILRCREflTETItlE _ (tihV*ILR~log created) 


RL'ILRLASTDATE 


_(last_log_access_date)_ 


"RL'ILRLASTTIFIE 


(last log access tine) 


RESERVED 




FOR 




FUTURE 




USE 


RL' nAINTUDRD 


(database Maintenance 




word) 


RL' BUFFERSPECS 


(buffer specifications) 



77 
100 



103 
104 



RL'CONDITION (IN ASCII): 

JB - Virgin. The database has not been created yet. 
FU - OK. The database is OK. 

Rn - P.odified deferred. The database is being nodified. 
I1C - ilaintenance create. The database is being created. 
HE - Ilaintenance erase. The database is being erased. 
IL - ILR recovery in progress. 



G.OO.OO 
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General Rootfile Layout 



Root File Label 0 (cont.) 

RL'DATE: Root file creation date*. Its fomat is: 

_0:J:_2:_3:J!:_5:_6:_7:_S:J:10:11:12:13:14:15 
lyear |day_of jiear I 



RL'TME: Root file creation tine*. Its fornat is: 



_0:_1:_2:_3:JI:_5:J:_?:_8:_9: 10:11:12:13:14:15 
Ihour ! ninutes_ 



General Rootfile Layout 



.'3UFFSPECS: 

BIT/ _0:_1: 2:_3:_4: 5: 6:_7:_8:_9:10:11:12:13:14:15 X 

UD 68 IbufferiforJ user Ibuffers for 2 users I 104 

69 Ibuffers for 3 users Ibuffers for 4 users I 105 

. I etc... ~ " I . 

• I , I • 

127 |buffers_forJ19 users_|buffers_for_120 users_| 177 



* The DATE and TIRE fields can be fornatted (for display purposes) 
individually by calling the FRTCALENDAR and FnTCLOCK Intrinsics 
respectively. Or both fields can be fomatted at once uith FNTDATE 
Intrinsic. 



|seconds_ 



_ I tenth_of _seconds_ 



RL'EVEROPEN: This field is no longer used under MflGE B 
RL'FLRGS: 

(0:1) - RECOVERY Default is NO (0! 

(1:1) - LOGGING Default is HO (0) 

(2:1) - ACCESS Default is YES (1) 

(3:1 ) - DUI1PING Default is HO (0) 

(4:1) - RESERVED-FOR-FUTURE-USE 

(5:2) - SUBSYSTEM ACCESS Default is R/U (00) 

(7:1) - ILR Default is NO (0) 

(8:2) - RESERVED-FOR-FUTURE-USE 

(10:1)- DIRTY FLAG Default is YES (1). 

This indicates the database has 
been nodified but not DBSTOREd. 
(11:5)- RESERVED-FOR-FUTURE-USE 

RL'STORDATE: Sane fomat as RL'DATE*. 

RL'STORTME: Sane fomat as RL'TIIIE*. 

RL'BUFSPECCOUNT: tlaxinun nunber of buffer specifications alloued. 
RL'ILRCREATEDATE: Sane fomat as RL'DATE*. 
RL'ILRCREATETIIIE: Sane fomat as RL'TIIIE*. 
RL'ILRLASTDATE: Sane fomat as RL'DATE*. 
RL'ILRLASTTIHE: Sane fomat as RL'TIIIE*. 

RL'tlfllNTUORD: For data bases uith no naintenance word this field has 
2 senicolons (';;') and trailing blanks. 
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General Rootfile Layout 


General Rootfile Layout 


Root Filt Labels 1 1 2 


Root File Label 3 


UORD 0 

1 
2 

3 


LABEL «1 Z 
I Passuord for user class 0 j 0 
I (this is a dunny field since user j 1 
j class 0 is not defined) I 2 
1 1 3 


LABEL 113 z 
UORD 0 | Itenl read/urite bit nap | 0 

1 1 11 

2 I | 2 

3 I I 3 

4 I | 4 


4 

5 


1 Password for user class 1 I 4 
I I 5 


5 15 

6 1 16 


6 
7 


I I 6 

1 1 7 


' 1 1 ? 

8 1 Iten2 read/urite bit nap j 10 

9 1 Ml 


J 
9 


I Passuord for user class 2 j 10 
1 1 11 
I I 12 
I I 13 


10 






t 1 ■ 

i t : 


15 i i b 

16 I Iten3 read/write bit nap | 20 

1? i i 21 

119 i i if.7 


124 
12S 

12? 


1 Passuord for user class 31 | 174 
j 1 175 
! f 176 
1 1 177 


0 

1 


LABEL K Z 
I Passuord for user class 32 I 0 
1 1 1 


120 | Iten16 read/write bit nap | 170 

121 I | 171 


2 

3 


1 I 2 
1 1 3 


127 i i 177 


4 

5 


I Passuord for user class 33 I 4 

1 1 s 




6 


1 1 6 
1 1 7 


The ITEfl READ/URITE TABLE starts in user label #3 

There are eight uords for each ITER READ/URITE bit nap. 

For databases uith nore than 16 itens, the read/urite table continues 

in the next user labels. The specific fomat of this table is explained 

after the SET REAO/URITE TABLE since it is defined the sane uay. 

The nunber of user labels occupied by the ITEfl READ/URITE TABLE depends 

on the nunber of data itens defined in the schena and can be obtained 

by rounding upuards (ceiling)the result of: 


8 
9 
10 
11 


I Passuord for user class 34 I 10 

! i 11 

1 12 

I I 13 




I I . 

i ' 


124 
12S 


Password for user class 63 | 174 
I 175 


Hun-of-labels = [(Nun-of-itens)»8)/T28 


126 
12? 


I 176 
1 177 


Since there can only be a naxtnun of 255 data itens in the schena, the 
naxinun size for this table in user labels would be: 

nax-size = [(25S)«8]/12S = 15.93 => 16 labels. 


The PASSUORD TRBLE occupies user labels nutiber 1 and 2. 
There are four words (8 characters) reserved for each password. The 
relative position of a passuord corresponds to the user class nunber 
defined in the schena. For user class nunbers not defined in the 
SCHEMA, the four word field is filled uith blanks. 


1 
i 
1 

j 
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General Rootfile Layout 


General Rootfile Layout 


Soot File 


next Label 


Iten/Set Read/Urite Table Fornat 






UORD 0 

2 
3 
4 
5 


LABEL •? z 
Set1 read/write bit nap | 0 
i 1 
1 2 
1 3 
1 4 
I 5 


There are eight uords per iten/set read/urite table definition 
and up to 16 itens/sets per record (user label). Uithin each 8 
uords, the first 4 words are the flags for the user classes which 
have read access to the iten/set. The second 4 words are the 
flags for the user classes which have write access to the iten/set. 
The detail fomat for an eight word field is shown below. 


6 

? 


1 6 
1 7 


A. Four words for read access: 


8 
9 


Set2 read/urite bit nap | 10 
I 11 


0 15 16 31 32 47 48 63 

1 word 1 1 uord 2 I word 3 1 word 4 | 


15 


i 17 


4 words represent 64 bits. Bit n represents read access for user 
class n to the iten/set. If bit n is set to 1 then user class n has 
read access to the iten/set. 
For exanple, if the word settings are: 


16 I Set3 read/urite bit nap | 20 
1? 1 1 21 






uord 1 uord 2 uord 3 uord 4 
X000016 Z020000 Z000410 ZOO13O0 


119 i 


i 1S7 


This neans that user classes 12, 13, 14, 18, 39, 44, 54, 56 and 57 
have read access to the iten/set. 

If no read/write security is defined at all for the iten/set, then 
all of the read security bits are set to 1. 


120 I Setlfc read/urite bit nap 170 

121 I I 171 


127 i 


i i?7 


B. Four uords for urite access: 


The SET READ/URITE TABLE starts on a user label boundary after the 
ITEH READ/URITE TABLE. 

There are eight words for each SET READ/URITE bit nap. 

For databases uith wore than 16 data sets, the read/urite table 

continues in the next user labels. 

The specific format of this table is shown in the next page. 


0 15 16 31 32 47 48 SI 

1 uordj | word 2 I word 3 I word 4 | 

Urite access flags have the sane fomat as the read access flags. 
Bit n represents urite access for user class n to the iten/set. If 
bit n is set to 1 , then user class n has write access to the iten/set 
For exanple, if the word settings are: 


The nunber of user labels occupied by the SET READ/URITE TABLE depends 
in the nunber of data sets defined in the schena, and is obtained by 
rounding upuards (ceiling) the result of: 


word 1 word 2 word 3 word 4 
Z0OOO10 Z020000 ZOOOOOO Z001100 


Nun-of-Iabels = [(Run-of-sets)«8]/128 

Since there can only be a naxinun of 99 data sets defined in the schena 
the naxinun size for this table in user labels is: 


This neans that the user classes 12, 18, 54 and 57 have urite access 
to the iten/set. 

If no read/urite security is defined at all for the iten/set, then 
all of the urite security bits are set to 0. 


Hax-size = [{99)*8i/128 - 6.18 => 7 labels 
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General Rootfile Layout 



Root File Record 0 



RECORD M 

uord 0 f ROOT ' DBSTRTUS_ 

1 |~RO0T'D8HAHE 

2 I 

3 I 
4 
5 
6 
7 
8 
9 



ROOT'TRLRLGTH 
~R00T'BUFFLGTH~ 

"ROOT'LGTH '_ 

,'ROOT'ITEBCT 

LROOT'SETCT 

10 IJOOT' ITEtlPTR_ 

11 |jo0t'dsetptr_ 

12 Preserved 

13 l 
" l 



_(trailer_area_length)_ 

_(buffer_Iength) 

~( rootfile length) ~ 

_(nunber_of_ltens) 

_(nunber_of_data_sets)_ 

~(iten_tabli_pointer) 

_(set_table_pointer) 

(set to blanks) 



16 
17 


| HOUOPEN 




1 hrxopen 




18 


I RESERVED 


(for future use) 






(set to binary Os) 


127 







z 

.1 o 

1 1 

I 2 
I 3 
J 4 

J 5 
-I 6 
J ' 
J 10 
J 11 
12 
13 
14 
15 
16 
17 
20 
21 
22 



ROOT'DBSTHTUS 

(0:8) - MAGE version ('B' in ASCII) 
(8:8) - Binary 1 (filler) 

ROOT'DBNHHE - DATABASE nane left justified (last 2 chars are blank). 

NOUOPEN - Nunber of data sets opened. This field is not used in MflGE B 

IfflKOPEN - ftainun nunber of data sets that can be opened. This field is 
not used in MAGE 8. 

NOTE: 

ROOT'ITEBPTR and ROOT'DSETPTR is a uord offset fron record 0 (be- 
ginning of the file, not including the space taken by the user la- 
bels) and can span several records. 

These pointers point to the Oth entry of the table and since the 
Oth entry in the iten table or the set table does not really 
exist, they actually point to 11 uords before the beginning of the 
table. To get to the first entry in the table, this pointer should 
be incremented by the length of the entry (which is currently 11 
uords). 
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Root File Record 1 



bits/ 


0: 1: 2: 3: 4: 5: 6: 


7: 8: 9:10:11:12:13:14:15 


1 


uord 0 


iten-nane-1 




0 
1 


1 
2 






2 


3 






3 


4 






4 


5 






5 


6 






6 


7 






^ 


8 


_iten-no-of - synonyn_ 


^ 

i reserved-1 


10 


9 


reserved-2 


1 iten-tvoe 


11 


10 


subiten-count 


1 subiten-lencith 


12 


11 


iten-nane-2 




13 


12 






14 


13 






15 


14 






16 


15 






17 


16 






20 


17 






21 


18 






22 


19 


_iten-no-of-synonyn_ 


1 reserved-1 


23 


20 


reserved-2 


I iten-type 


24 


21 


subiten-count 


| subiten-lenqth 


25 


22 






26 



The ITEtl TABLE starts in record #1. 

Each entry is 11 uortis long and the length of the table depends on the 
nunber of data itens defined in the schema. The relative position of 
an iten definition depends on its relative position in the schena. 

Iten-nane: is a data iten nane, left-justified and uith trailing blanks 

Iten-nunber-of-synonyn: is the nunber of the iten uhose nane has the 
sane hashed result as this one (this is 
utilized for quick iten nane searches). 

Iten-type: is one of the follouing: I, J, K, R, X, U, I, or P 

iten-type 

I 

VALUES, 20J2; 

i | subi ten-length 
I subiten-count 

The naxinun size for this table is 11*255 = 2805uds 



The reserved-1 and reserved-2 fields are the 'old' level nunbers 
for read and urite security. Nou, the values are aluays zero. 
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Ge'neral Rootfile Layout 



Root File- NExt Record 

bits/ _0:_1:.2:_3:_4:J 

uord 0 | set-nane-1 

1 I 

2 I 

3 ! 

4 I 

5 I 
6 
7 



8 |_set-no-of-synonyn 

9 |_reserved-2 

10 j "DSCB-pointer 

11 I set-nane-2 

12 I 

13 I 

14 I 

15 I 

16 I 

17 I 

18 I 



I reserved-1 
_|~data-set-type_ 



19 |_set-no-of-synonyn_ 

20 |~reserved-2 

21 | DSCB-pointer 

22 f 



6: 7: 8: 9:10:11:12:13:14:15 I 

0 

1 
2 
3 
4 
5 
I 6 
I 7 
I 10 
I 11 
I 12 
I 13 
I 14 
I 15 
I 16 
I 17 
I 20 
I 21 
I 22 

;i 23 

I 24 
.I 25 
I 26 



I reserved-1 
_|_data-set-type_ 



Set table follous the Iten table. 

Each entry is 11 words long. The length of the table depends on the 
nunber of data sets defined in the schena. The relative position of a 
set definition depends on its relative position in the schena. 

Set-nane: is a data set nane, left-justified and with trailing blanks. 

Set-nunber-of-synonyn: is the nunber of a data set uhose nane has the 
sane hashed result as this one (this is utilized 
for quick set nane searches). 

Data-set-type is one of the follouing: A, 11 or D. 

DSCB-pointer: is a pointer to the Data Set Control Block. This 
pointer is uord offset fron record 80. The DSC8 is 
described ahead. 



The naxinun size for this table is 11*99 = 1089uds. 



The reserved-1 and reserved-2 fields are the 'old' level 
nunbers for the read and urite access respectively. Since 
this concept no longer applies, the walues are set to zero. 
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Data Set Control Blocks (DSCB)- General Layout 



OfiTfi SET GLOBAL AREA (set 1) 

(capacity, lengths, counts, etc.) 



"RECORD DEFINITION TABLE (set 1) 

a. ITEfl NUNBERS 

b. ITEtl DISPLACEMENT 



fieidcount*2+2 I 

PATH TABLE Tset~l7 I 
(search iten, sort iten, etc.) 

pathcount*2 j 



DATA SET GLOBAL AREA (set 2) i 
(capacity, lengths, counts, etc) 

30 uds. I 

I 

I 
I 



"RECORD DEFINITIONTTRBlE (set 2) 

a. ITEtl NUnBERS 

b. ITEN DISPLACEflENT I 

fieldcount*2+2 I 
I 



"PATH TABLE Iset _ 2"J 

(search iten, sort iten, etc.) 



DSCB 
setl 



DSCB 
set2 



DATA SET GLOBAL AREA (last set) 

(capacity, lengths, counts, etc) 



I > 

I > 

30 ads. I } 

! > 

I > 

I } DSCB 

I > last set 



"RECORD DEFINITION TABLE (last set) 

a. ITEI1 NUflBERS 

b. ITEM DISPLACEflENT 

fieldcount*2*2 I > 

_ _ I > 

'path Table Tiast set) I > 

(search iten, sort iten, etc.) I } 

pathcount*2 I } 

I ) 



The DSCBs follou the SET TABLE in the Root file. 

There is one DSCB for each data set defined. The function of the DSCB 

is to define each data set uithin the data base. 
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General Rootfile Layout 



Data Set Control Block (Global Urea) 



bit/ 

word 0 
1 
2 
3 
4 
5 
6 



.0:_1:_2:_3:_4:_5: 6: 7; 8: 9:10:11:12:13:14:15 t 
OSCSP (data set capacity) | 0 
I 1 



DSBLOCKLGTh (block length) 

OSflEDIdLGIn (Media"record length) 
DSENTRYLGTN (entry'lengthj ' 
DS8L0CKFRC " " " 
OSPRTHCT 



OSFIELDCT 
! H| DSPRIrtKEY 

7 L0SPSTHPTR3__(offset to path tableX 

8 I logical end of file 

9 I 

10 | nax nun of records in set 

11 I 

12 j 18 words of binary zeros 



2 
3 

.I 1 
I 5 
I 6 

J 7 
I 10 

J 11 
I 12 
I 13 

T H 



29 |_ 

OSCflP 

DSfiLOCKLGTH 
DSKEOIBIGTH 

OSENTRYLGTH 
DSBLOCKFRC • 
DSFIELDCT - 

OSPHTHCT 

X-DSKEYTYPE ■ 

OSPRMKEY - 



35 



DSPflTHPTR - 



- data set capacity as reported by the SCHEIW processor. 

- data set block length including the bit nap overhead. 

- data set nedia record length (renenber that this length 
includes the pointer overhead) 

data set entry length. 

data set blocking factor. 

data set field count. This is the nunber of fields 
specified for the data set. 

data set path count. This is the nunber of paths that are 
specified for the data set. 

data set key type. If DSKEYTYPE = TRUE then 
the key is hashed. 

data set pritiary path or key. 
For naster data sets, this is the field nunber of the 
search iten. 

For detail data sets, this is the field nunber of the 
prinary path. 

data set path table pointer. Uord offset to the data set 
path table uhich contains an entry for each path defined. 
It points to path Oth entry in the table, so to get to 
the first entry the pointer should be incremented by the 
length of the entry (uhich is currently 2 uords). 
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General Rootfile Layout 



Data Set Control 81ock (Iten nunbers) 

J>:J:J:J:J:J;J: 7: 8: 9:10:11:12:13:14:15 
uord 0 l_iten_nun_ofj8t_fi(ld I iten nun_of 2nd field I 
1 Liten_nu«_of_3rd_ficld |"etc. " ~ " j 

■ I etc - - - - j bina| ^ q j 

. |_binary_0 !~binary 0 ~ ~ l 

The Iten Bunbers Table follous the Global Area of the OSCB. 
The size of this table (in uords) is equal to the nunber of itens in 
the given data set plus 1. The first n bytes are used to carry the iten 
nunbers of the fields uithin the data set. The renaining nt2 bytes are 
set to binary zeros. 



Data Set C ontrol Block (Record Definition Iten Displacement) 



J>:_1:_2:_3:_4: S:_6:_7:_8:_9: 10:11 : 12: 13:14: 15 
word 0 |_uord_offset_to first field 

1 l_uord_offset~to~second field_ 

2 l_uord_offset_to~third field 



l_uord_offset_to_last_field_ 
l_length_of_entry 



General Rootfile Layout 



Oata Set Control Block (Path Table) 



This table innediately follous the Iten Nunbers Table. 

The uord offset points to the starting location of the field uithin the 
nedia record. Renenber that the nedia record includes the pointer over- 
head so this offset varies for naster and detail data sets: if a naster 
data set has only one path, the uord offset for the first field is 10, 
since there are 10 uords of overhead— 5 uords for the synonyn chain 
pointers and 5 uords for the data set chain head that it uould be point- 
ing to. On a detail data set Mith one path, the overhead is only 4 
uords. 

The 'length-of-entry' field is the sane as the nedia record length. 
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General Rootfile Layout 



_0:_1:_2:J:_4:_S:_6: ? : 8: 9:10:11:12:13:14:15 
uord 0 | 1st path definition " | 
' l_ I 

2 I 2nd path definition | 

3 I 

4 |— — 



L 



last path definition 



I 



There are 2 uords (4 bytes) for each path definition. 

The PATH TABLE for naster data sets has a different layout fron the 

PATH TfiSLE for detail data sets. 

naster sets: 

Byte Description 

1 - iten nunber of the search iten in the related 

detail set. 

2 - iten nunber of the sort iten in the related 

detail set. 

3 - set nunber of the related detail data set 

4 - path nunber of the corresponding path in 

the related detail data set. 

Detail sets: 
Byte Description 

1 - field nunber of the search iten. 

2 - field nunber of the sort iten. 

3 - set nunber of the related naster data set 

4 - path nunber of the corresponding path in 

the related naster data set. 



General Data Set Layout 
_USER_LfiBEL_0_ 



.RECORD 0 through n_ 



data records 



Uord 0-1 | nasters=capacity 

I details=highuater nark 

Uord 2-3! 

I nunber of unused records 



Uord 4-5 j nasters= not used 

|details= delete chain head 
! 



Record n 
Data Set (Iser Label 0 



Uord 0-1: Record nane of the highest readable record. 

For Rasters, this is the highest record in 
the set (i.e. Capacity). For Details, 
this is the greatest nunber of records that 
have been uritten to the set thus far. For 
exanple, if there is roon in the Detail data 
set for 100 records and 75 uere uritten last 
ueek uhen the data set uas loaded uith 
DBLOflD, and yesterday 15 records Here deleted 
fron the data set, the "High Hater nark" 
is equal to a value of '75'. 

Uord 2-3: Nunber of unused records in the data set. This 
field is increnented when a record is deleted 
and decrenented when a record is added. To 
deterriine the current nunber of entries used 
in the set subtract Uord 1-2 (unused count) fron 
Uord 0-1 (capacity). 

Uord 4-5: The delete chain head for Details. This points 
to the record nost recently deleted or contains 
a value of zero if no records have been deleted. 
This field is not used in flaster data sets. 



Data Set Records 

The data in the data set records is arranged according 
the nedia records. These are formatted by the Schena" 
Processor (DBSCHEHfl). 
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CHAPTER 22 DISC FREE SPACE HHP 
Disc Resident Data Structures 



There are tuo disc resident Free space data structures, the bit nap and the 
descriptor table, for each disc volune that has a free space nap, i.e. systen 
discs and private volunes. The addresses of these data structures are kept 
in the disc label. The synbols that define the descriptor table and bit nap 
are in the include file INCLDFS2. 



Bit Hap 



The bit nap is divided up into pages, uhich is the physical block of the nap 
that is read or written, fit the rtonent, a page is defined to be one sector 
(128 uords) long, this nay be changed by changing a conpile tine constant. 
The last uord of the page is a checksun for that page, all other words are 
data. There is a one to one correspondence between bits in the nap and sec- 
tors of the disc. A one bit represents a free sector and a zero bit 
represents an allocated sector. The bit nap is a contiguous set of pages, 
enough to represent the entire disc, excluding spare tracks and spare 
sectors. 



Descriptor Table (DT) 



The descriptor table is an array of three uord entries, one entry for each 
page of the bit nap. Each entry looks like this: 



word 0 = largest space 



uord 1 = starting space 



uord 2 - ending space 



Thus the descriptor table looks like this. 
= = entry for page 0 
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Disc Free Space 



= entry for page 1 
= entry for page 2 
~ entry for page 3 



= entry for last page 



Each entry describes the free space on the corresponding page of the bit nap. 
The largest space uord is the size of the largest contiguous block of free 
space on the page, uhich is not at the very beginning or very end of the 
page. That is, the first bit physically representing the space is not the 
first bit of data on the page or the last bit representing the space is not 
the last bit of data on the page. Starting space is the nutiber sectors of 
contiguous space represented by the set of bits whose first bit is the first 
bit of data on the page. Ending space is the nunber of sectors of contiguous 
space represented by the set of bits uhose last bit is the last bit of data 
on the page. The starting space and ending space fields allow looking across 
page boundaries, thus preventing f ragnentation on page boundaries. Thus, if 
all sectors represented on a page are free, then starting and ending space 
uill be the sane and have the total nunber of free sectors represented on the 
page. Largest space will be zero, as there is no block of space that is not 
at the beginning or end of the page. A value of - 1 for all the fields in an 
entry indicates the corresponding page is bad, either fron a checksun or I/O 
error. 



Virtual flenory Resident Data Structures 



For each systen disc or physically nounted private volune there is a data 
segment uhich has information about the disc free space nap, the current copy 
of the descriptor table, sone work space for the procedures while in split 
stack node and buffers for pages of the bitnap. The DST nunber of the data 
segnent for a given disc is found in the LDTX entry for that disc. 

Disc Free Space Data Sequ ent 

For each systen disc or physically nounted private volune in the up and run- 
ning systen there is a DST which contains information about the disc free 
space nap for that disc, sone work area, a copy of the descriptor table and 
buffers for the pages of the bit nap. All synbols that define these data 
segnents are in the include file INCLDFS1, and they are prefixed uith "ds"'. 
The structure of the data segnent is as follows: 



0 (») > 
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Disc Free Space 



Disc Free Space 



ds'dst 
ds'disc'size ■ 



ds'nap'address ■ 



1 CM) = 

2 (12) = 

3 S3) - 

4 (X4J = ds'last'page'of 'nap 

5 (%5) = ds'last' buffer' index 

6 (16) = 

7 (17) ' 
S (Z10) = da' lock 

9 (Z11) = ds'lock'count 

10 (Z12) = ds'queue'head 

11 (Z13) = ds'queue'tail 

12 (X14) = ds' descriptor' table 

13 (311 S) - ds'buffer'page'nunber 

14 (Z16) " ds'buffer'dirty 

15 (Z17) - ds'buffer'area 

16 (Z18) = ds'first'tbreshold'page 

17 (221) = 

18 (Z22) = 



- ds'size'of'last'allocation 



19 


(Z23) 




ds'last'page'allocated'f run = 


20 


(Z24) 




ds'next'buffer' index = 


21 


(Z25) 




ds'page'nunber = 


22 


(Z26) 




ds' uord 'nunber = 


23 


(Z27) 




ds'bit'nunber = 


24 


(Z30) 




ds'page'pointer = 


25 


(Z31) 




ds'starting'uord'nunber = 


26 


(Z32) 




ds'starting'bit'nunber = 


27 


(Z33) 






28 


(Z34) 






29 


(Z35) 




ds' bit 'count = 


30 


(Z36) 




ds' entry' type = 


31 


(Z37) 




ds'buffer' index = 


32 


(Z40) 








(Z41) 






34 


(Z42) 




ds'error'status = 



The rest of the data segnent contains tables uhose size and location is 
dependent on the size of the disc and or the nunber of buffers in the data 
segnent. They are shoun belou just to denonstrate there relation to one 
another, for there actual location, the pointers should be exanined. The 
synbol "ds'array'area" defines the start of the area. The first table is the 
descriptor table, it is in the sane fornat as the disc copy, but a dunny 
entry of all zeros is added before and after the table, these are needed by 
procedures "Find'Page" and "Build'Descriptor'Entry". The pointer to this 
table is "ds'descriptor'table", it points to the entry for page zero, not the 
dunny entry. 



E.00.00 

21- 3 



G.00.00 
21- A 



Disc Free Space 

0 

2 , = (jUMHV 

0 

~ - 3 entry 

0 

= largest space = 

" - entry for 

= starting space = 

= s page 0 

B ending space - 

= largest space = 

" entry for 

- starting space = 

= " = page 1 

= ending space = 

= largest space = 

= = erItry f or 

- starting space = 

" = last page 

- ending space = 

0 

' dunriy 

0 

= _ entr y 

0 

The next table is ds'buffer'page'nunber table, it has a one word entry for 
each buffer in the data segnent. Each entry contains the page nunber of the 
page currently in the corresponding buffer or -1 if the buffer is enpty. 
This is pointed to by "ds'buffer'page'nunber". 



buffer 0 entry 
buffer 1 entry 
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Disc Free Space 



last buffer entry 



The next table is the ds'buffer'dirty table, uhich has a one uord entry for 
each buffer, fi TRUE indicates the page in the corresponding buffer is dirty, 
i.e. the disc copy is not up-to-date. R FfiLSE indicates that the buffer is 
clean, If DFS was conpiled with dirty buffer nanagenert turned off, this 
table is not present and the ds'buffer'dirty pointer is zero. 



buffer 0 entry 
buffer 1 entry 



last buffer entry 



The renainder of the data segnent contains the buffers, each buffer is the 
size of one page of the bit nap, which is currently one sector(128 words). 
The beginning of the buffer area is pointed to by "ds'buffer'area" and the 
nunber of buffers is the value in "ds'iast'buffer'index" plus one. 



&.00.00 
22- 6 



Each of the fields of the data segment is described in the include file 
INCL0FS1, where they are defined. It should be noted that the following 
fields are just workspace, used to pass information between procedures while 
in split stack node and have no neaning between calls to the disc free space 
«anagenent subsystem: 



ds'page'nunber 
ds'bit'nunber 
ds'starting' word' nunber 
ds'nunber' of 'sectors 
ds'bit'count 
ds'disc'address 



ds' uord' nunber 

ds'page'ptr 

ds' starting' bit' nunber 

ds'entry'type 

ds'buffer'index 



The field ds'error'status nomally has no Meaning between calls unless the 
error'type field has a value greater than "fatal'dfs'error", in uhich case it 
neans that disc space nay no longer be allocated on this disc. 
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Disc Caching 



CHAPTER 23 HPE DISC CRCHXNG 



Disc Caching Overview 



Disc Caching is an optional feature of HPE that utilizes excess nam nenory 
and excess CPU horsepower to keep portions of frequently referenced disc 
"donains" in nenory. (R disc "donain" is a copy of a portion of disc resid- 
ing in nam nenory. These disc donains are considered "cached" uhen they are 
in nenory and are considered "napped" uhen there is I/O pending against 
then. ) Disc Caching nanages the bi-directional transfer of these disc 
donains between nain nenory and disc storage. No nain nenory is permanently 
dedicated to cached disc donains. Cached disc donains share nain nenory Mith 
all ether types of nPE segnents and are not treated differently by the nenory 
nanager. By keeping cached disc donains in nenory, a significant portion of 
the references to disc storage can be resolved without actually having to 
physically access the disc. Disc Caching policies are integrated into the 
HPE Kernel, File Systen, and I/O Systen which allous the systen perfornance 
to be tuned based on the current uorkload and resource availability. 

Disc Caching uses the fIPE kernel resource nanagenent nechanisns and 
strategies. These nechanisns are extended to handle cached disc donains in 
the sane nanner as segnents. Thus, cached disc donains can be of variable 
size, fetched in parallel with other segnents or cached donains, garbage col- 
lected, and replaced in the sane nanner as stacks, data and code segnents. 
The relative use of nain nenory between stacks, data and code segnents, and 
cached disc donains is dynanic. This partitioning is baaed on the workload's 
current requirenents and current nenory availability. 

Disc Caching can be enabled/disabled on a disc by disc basis. Uhen caching is 
enabled for the first disc, the code segnent containing the Disc Caching code 
uill be locked into nenory. Also at this tine the Cache Directory Table (CDT) 
uill be built and locked into nenory. Uhen caching is disabled for the last 
disc, the code segnent will be unlocked fron nenory and the CDT uill be 
released. Thus if caching is not enabled no nenory will be wasted. 

The CDT is used to keep track of the following information: 

1) The disc ldevs currently enabled for caching. There will be a 

Device Entry in the table for each cached disc. 

2) fl linked list of cached donains for each disc uith caching en- 

abled. The head and tail of this linked list will be contained 
in the Device Entry. (I.e. there is a separate linked list of 
cached donains for each cached disc ldev.) 

3) The cached donains that currently have user I/O pending (i.e. 
FREflDS/FURITES) or have nenory nanagenent I/O pending (i.e. 
fetching the disc donain into nenory, or posting the disc 
donain back out to disc). There will be a Happed Donain Entry 
in the table for each disc donain has that I/O pending and is 
thus "napped". 



5.00.00 
23- 1 



Disc Caching 



ordered writes include things like updating disc free space naps for a new 
file extent before updating the file extent nap in the file label. 

There are two disc request entries used for disc caching requests. The first 
entry is a Logical Disc Request (LDR) entry and is used to nanage the data 
noves to/fron the user's data area and the disc donain (i.e. the logical 
I/O). The second entry is a regular Disc Request (DRQ) entry and is used to 
perforn the physical I/O necessary to nap a disc donain (for a read "niss") 
or to perforn the physical post (on write requests). The disc donain will 
renain napped until both the logical and physical I/O conpletes. If a request 
is not conpletely described by one disc donain already in nenory or a Happed 
Donain CDT entry (i.e. the requested disc area falls into nore than one disc 
donain) then the overlapping disc donain(s) uill be flushed to disc and the 
new complete disc donain will be fetched (if read) and napped - no partial 
nappings are allowed. 



The DST nunber of the Cache Directory Table (CDT) is at 21273 and the bank 
and offset are kept in X1274-X1275. The Caching Sir (2) is used when starting 
and stopping caching (via : STARTCRCHE/: STGPCRCHE ) and by the LOUDER when 
loading a progran file (this sir is only used when updating the STT at load 
tine). 

Uhen caching is enabled for a disc, a bit in the flags word of the DIT is 
set. Rlso, the Global Serial Write queue can be found by exanining the 
header entry of the Disc Request Table. See Chapter 13 For a nore detailed 
explanation of both the DIT and the Disc Request Table header. See Chapter 2 
for a description of the tlenory Region Header for a disc donain (cached 
region). 



4) R linked list of all uttr I/D pending against the napped disc 
donains. There uill bt a Logical Disc Request (LDR) queued to 
the Happed Donain entries that uill describe the user I/O to 
take place. This is analogous to a Disc Request queued to a 
specific DIT waiting for service. 



Uhan a request is itade to access disc information, Disc Caching nutt first 
deternine if the requested disc donain is present in ntriory. Disc Caching 
uill first determine if the requested area of disc is already nappfd into 
nenory by scanning through the Napped Donain entries of the CDT. If the 
requested transfer can be satisfied with a currently napped disc donain, then 
the I/O request will be queued (FIFO) behind the other I/Os pending against 
that napped donain. If the requested area is not already napped, then a 
search is nade through the linked list of cached disc donains for the 
specified disc ldev. (The region header contains the disc address and size 
that a disc donain represents.) If the requested donain is found in this 
list (i.e. present in nenory), then this region will be napped. A donjin is 
then considered napped uhen there is an entry for it in the Happed Donain 
portion of the CDT. Happing the donain allous Disc Caching to nanage the I/O 
pending and/or currently active for a particular disc donain. Once the disc 
donain is napped and present, the data can be noved between the process' data 
area and the napped disc donain. The process can then continue executing 
without interruption or a process switch. The user/subsysten process for 
which the nove is done will be charged uith the CPU overhead. 

Uhen a request is nade to read data that is not currently cached in nenory 
(i.e. a read "niss"), the fetch strategy uses the File Systen's knowledge of 
the type of access (sequential or randon), the extent size of the file, along 
with the current nenory load to select the optinal size of the disc donain to 
be fetched and napped into nenory. The fetch of the disc donain is then in- 
itiated on the user's stack without a process switch. After the fetch is in- 
itiated, it conpletes in an unblocked nanner so that this process (if no-wait 
I/O) or another process can proceed in parallel uith the cache fetch. 

In general, uhen uriting, a process will not wait for conpletion of the 
physical I/O. Instead, the process uill be awakened as soon as the transfer 
has conpleted between the process's data area and the napped disc donain 
(i.e. no-wait-for-post). The physical I/O will then be posted at background 
priority uhile the process continues. (Users can specify uait-for-post on a 
file by file basis in place of the default no-wait-for-post uith the FSETHODE 
intrinsic. This can be done on a global basis via : CflCHECONTROL. ) If the 
access request is a write and there is a current write pending against the 
specified napped disc donain, the process request is queued until the pending 
write is posted to disc. If the disc donain to be written is not currently 
cached in nenory, a free piece of nenory uill be obtained to nap the cor- 
responding disc inage and then the "write" takes place fron the process' data 
area to the napped disc donain. This prevents data fron having to be read 
before being written. After that, a post to disc is initiated (on any write 
only the portion of a napped disc donain that is Modified uill be posted to 
disc). After the nove to the napped disc donain is conplete and the post to 
disc is initiated, the process performing the "write" is allowed to continue 
to run without having to uait for the post to conplete. Urites that nust be 
posted to disc in a certain order use the Global Serial Urite Queue. These 
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Disc Caching Tables Overview 



Cache 
Directory 
Table 
(CDT) 



I Header | 

I (Info for table ngt) I 



+ j Device entry ft 1 \ 



j Device entry ft 2 j 



I | Device entry ft N | 

I | > 

! r~ " " i< 

Happed Donain ft A (===============> to 1st Logical 

I +->| for Dev # 1 j— + Disc 

j | | | Request 

I I I II Entry 

I +— | Happed Donain ft B |<-+ (LDR) 

j +->( for Dev ft 1 |--+ 

| | | 1 | 

111 II 

I +— | Happed Donain ft C |<-+ 

I I for Dev ft 1 | 
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Hgnory Regions 



->j 1st Cached Region 

j (Cached disc donain) 

-I (Dev «U 
I 



I ! 



! 

->| 2nd Cached Region 
j (Cached disc dotiain) 

-I (Dev »1) 
I 



| Flapped Cache Region 
j (flapped disc donain HA) 
I (Dev #1 ) 



Last Cache Region 
(Cached disc doriain) 
(Dev 81 ) 
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Cache Directory Table 



The Cache Directory Table (CDT) is the bookkeeping structure for nanaging 
cached disc donains. This table is divided into 3 parts: 

CDT Header Entry 

This entry contains all infomation necessary to Manage the entire table and 
also contains global caching related infomation. 

CDT Device Entry 

There uill be one of these entries for every disc ldev that currently has 
caching enabled. These entries keep track of all cached disc donains in 
nenory for this device. In addition, these entries contain statistics regard- 
ing the nunber of I/Os perfomed to the ldev. 

CDT Happed Donain Entry 

These entries describe disc donains that are currently "napped" into nenory. 
This neans that there is logical I/O (cache nove) and/or physical I/O (fetch 
or post) pending. These entries keep track of the state of the cached disc 
donain (IHI, ROC, etc.) just as the DST Table keeps track of data segnents. 



The follouing lou core cells contain the address of the CDT: 

11273 contains the DST Nunber of the CDT 

X1274 contains the Bank KuHber of the CDT 

X1275 contains the Offset uithin the bank of the CDT 
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Header Entry 



0 


ft Entries 


CUT 'ENTRIES 


1 


Entry Size (HO) 


CDT 'SIZE 


I 


# Free Entries 


COT' FREE' COUNT 


3 


1st Free Entry (table oFfset) 


CUT'FREE'HEBD 


1 


Last Free Entry (table offset) 


COT'FREE'TRIL 


5 


Flax R Entries Used 


CuT'hTW'USED 


6 


# Ldevs cached 


CDT'HW LDEVS 


7 


1st Cache device entry (entry nunber) 


CDT'DISC'HEftD 


X10 


# Uords this DST 


CDT'DST'UORDS 


111 


TRUE if stopcaclie pending 


CDT'STOP'PHD 


112 


1* Sectors sequential fetch 


CDT'SEQ'tllNFTCH 


113 


# Sectors randon fetch 


CDT'RND'nTHFTCH 


X14 


TRUE if uait for physical post 


CDT'FORCE'POST 


X1S 


Head of inpeded queue (PIN) 


CDT'STOP'QUEUE 


116 






Z27 
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CDT 'ENTRIES 

The total nunber of CDT entries configured in this table (i.e. includes all 
three types of entries). The nunber of entries in the table uill be: 
1 entry for the header 
+ 1 entry for each disc ldev configured. 

(CDT Device entries) 
+ 1 entry for each DRQ configured. 

(CDT napped Donain entries) 

This schene insures that this table can never overflou (since an entry in the 
DRQ table is always obtained before an entry in this table). 

CDT* SIZE 

Size of each entry in the table. 
CDT'FREE'CQUNT 

Total nunber of entries currently unassigned. 
CDT 'FREE 'HERD 

Table relative offset (i.e. Entry nunber * entry size) of the first available 
entry. 

CDT'FREE'TBIL 

Table relative offset of the last available entry. 
COT'HRX'USED 

The naxinun nunber of entries in use at one tine. 
CDT' NUH' LDEVS 

The nunber of ldevs currently cached. 
CDT'DISC'HEftD 

The entry nunber of the first Device Entry. 
CDT'DST'UORDS 

The total nunber of uords in this data segnent. 
CDT'STOP'PHD 

This value uill be TRUE if there is a pending :STOPCftCHE. 
CDT'SEQ'fllNFTCH 

If there is a prefetch for a sequential read ("niss"), the size of the 
prefetch is delinited by the extent size of the file. Uithin this linita- 
tion, the prefetch is equal to the greater of two sizes: 

1 ) Requested size. 

2) The largest integer Multiple of the request size that is snaller 
than the value found in this cell. 



The default value is 96 sectors. (This value nay be changed vis 
:CRCHEC0NTR0L). 

CDT'RND'niNFTCH 

This is the sane as i'Oi : SfcQTittf 11H except tnat it's io r ranaoti access. The 
default value .is 16 sectons. (This value way be changed via ;CPCHECQNT^nj_}. 
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COT' FORCE* POST 

Uhen :hn value it TRUE, all writes mil 'block" -Mil the physical update an 
disc Completes. The systen oefault is FALSE. (Can be altered via 
:CflCHECD»*TROL). 

COT 'STOP' QUEUE 

If COT' STOP 'PEHOIHG is TRUE this will bt tnc PIN mjnbtr of tht head pin of 
the processes impeded until tht :$T0PCACH£ conpiette. 


i 

Devics Entry 

0 | Kent idtv entry (ar*ry "iwrterj i C"'>£'>; " 

1 | Prev ldev entry (ent-y nyneer) i C5*' 3£' ?R£if LDEV 

2 1 Ldev for this disc 1 COT'QE'LSEV 




3 i « ? ag*s in device's danam , C.j7 : 3E'?Wr"AS 




4 '■ * Sue dcnams c.rrsn'Iy tipaed , W'2i"?.H?$' Itf 




1 

5 1 Head of nappes donain (entry *'J«ber) : CDT'Ot 1 ■.■S^fi" h£fi(J 




S i Tail of capped donain (entry *«"ber) 1 CDT' "£' IflPD' T fllL 

i I 




7 j k 3isc dc-j;r". '■ajicn* for this device 1 CDT'Ct'SESIOHS 




110 1 ftency .address of iiead I CDT'DE'SfC-'HD 




1- -1 
I cached disc strain ! 




1 1 
112 I "enory awress of tail i COT'DE'REO'Ti 




i c acred disc donam j 




XI 4 i - CDT "DE' WIT 
i- S Read hits -j 
1 ! 




1 1 

Z16 | i CDT'SE'liHIT 
i- * write hits -1 

! i • 
! i 




Z20 1 1 CDT'Dt'SniSS 
i - # Read msses - ' 
1 




122 i ■ :;t'0£'=h;ss j 

1- « Urite hisses -j 1 

1 i i 




1 1 j 

Z24 | j :dt'D£- : r c? < 
!- * Steps -1 i 

f i ; 




X2S 1 nenory aaaress Jf list ; ".D* ' >E ! SCimPT f 




!- -i ; 

! referenced jc.uin i 1 
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i 


CDT'OE'HEXT'LDEV 

The entry nunber of the next Device Entry. 
CDT'DE'PREV'LDEV 

Tne entry nunber of the previous Device Entry. 


CDT'CE'StlISS ! 
Total "unber of Tines that a read ;ias ^eq.csJed ard tne -e^.ested iisc icnain 
was r.ot in lenory - i.e. a -ead "mss". '.us iear.s tr*t tr-e recwested disc 
aonain had to ba Fetched into nenory before the read tould ccnplate - thus 
potentially Blocking the process. This value mil r*set to 2£-o on overflow. 


CDT'DE'LDEV 

The Ldev nunber for this cached device. 
CDT'QE'nWPBGES 

Total nunber of nain nenory pages allocated to disc donains for this cached 
device. This includes napped and unmapped regions. (1 nam nenory page = 128 

words). 

CDT'D£'flfiPO*CHT 

The total nunber of dapped Donain entries associated with this Device Entry. 

. COT'DE'flflPO'HEflO 

The entry nunber of the first flapped Donain entry for this device. 

CDT'DE'flWTftTL 

The entry nunber of the last flapped Donain entry for this device. 
COT 'DE' REGIONS 

The total nunber of disc donain regions for this ldev (includes napped and 
unnapped regions), 

COT'OE'REG'HO 

flenory address to the head region of the disc donain linked list. Disc donam 
regions are linked in order based on the disc address they represent (i.e. 
snail disc address at head, large disc address at tail). This address will 
not point to the region base (RB), but to the next donain (HO) field of tht 
region header. (This it to facilitate the use of the LLSH instruction). 


CCT'DE'URISS 

Tctal .-j^cer of tir.es :rat i .r>:e „js -jq'-ested ard the '-aq^estao disc * 
dcnain -as ->et m -encry - i.s. a *r.:e "■■ise". "his dees i:t *e$n that the ! 
process would Dice* until tre disc coi-am is -"etched as ;s the case for j 
reads, father, a free le^ory ■■egicr, ■-cjIq fce obtained t; ;s the destination j 
of the racre i-cve. This disc Sonain .joula then fce postad background ! 
(■jniass overridden via -C**CncC2sTRGL or tTTGDE ) aili.i-g -ne c-ocass to 
continue without blocking. This value jiU reset to zers on o»erf Lou, ; 

CDT 'DE' STOP 1 
Total niinber of tiies that a process had to clock on a cache transfer. Uill j 
reset to zero on overflow. 

CDT'DE'SCflNPT 

The tenory address of the last region locked at en j s;arch. ""his address 

uill be of the next donain (NO) field of the -;g:on "=ioer. "his val-je --.ill 

be used along yith CQT'"3£'"!Ej'HD to Ceter^i^e -^e-e to sti.-t the -cxt search 

for a cached disc donain fit tines it -ill ba nore efficient to start uith 

this address since the disc donain requested nay be of a Higher disc address < 

than found in this region header, rather than aluays starting the search uith , 

COT'OE'REG'HO. | 



CDT'OE'REG'TL 

Henory address of the tail region of the disc donain linked list. This ad- 
dress uill bt of the previous donain (PO) field of the region header. 



CDT'DE'RHIT 

Total nunber of tines that a read uas requested arid the requested disc donain 
-jas present in nenory - i.e. a read "hit". This neans that the read conpleted 
without perfoming any I/O (to fetch the donain). Thus this is actually the 
nunber of read I/Os elininated. This value uill reset to lero on overflow. 

CDT'DE'UHIT 

Total nunber of tines that a urite ^as requested and the requested disc 
donain uas present in nenory - i.e. a urite "hit". If there was no other 
urite pending to the "hit" donain, then the process would continue as soon as 
the cache nove conpletes - thus eliminating a block for I/O. Otherwise, the 
process uouid black waiting for the first write to conplete. This value will 
reset to zero on overflow. 
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happed Donam Entry 

0 I Prtv napped dentin entry (entry nunbtr)| COT'flu'rflEV 
I I 

1 I Hent napped donain entry (entry nunber)| CDT'flO'NCXT 

2 | Start sector I COI'W'SECIW 
I- -I 

| address i 

I I 

4 | Last sector I CDT" WEHO' SECTOR 

I- -i 
f address 
I I 

6 I R| II I| HI II F| R| V| HI SI IS 3 I COI'rO'FLfBS 
I Bl m n| II 01 U| 0| I| 01 El /I T | 

I SI I| 0| S| C| II CI K| PI 01 /I A I 
I El I I SI Kl PI I CI 01 I /I T | 
I H| | 1 IE! I I II SI I /I E I 

I ri i | i oi i | hi ti i /| i 

I - I 

7 I • Reads pending I CDT'tlO'REBO'CHT 
I I 

lift | * Untes pending I CDT' W) ' WRITE' CHT 

I I 

1111 UxM uliting I COT'nO' LKO'CDT 

I I 

112 I Head of inpeded LDP. I COt'BO'lnfEO'HO 
I I 

113 1 Head of active LOR I COT' HO' LDR 'HERD 
I- I 

114 | Itenory address I CDT'110'fiEII'flOR 
I- -I 

I if present I 

| | 

Hi I Dlig for this napped donam I CDT'WOISCREO 

I I 

117 | • Flushing COIs I CDT'nO'lK'CHT 

I I 

120 I ldev for this napped donain I COT 'HO' LDEV 
I I 

121 I Head inpeded queue (PIH) I CDI'HO'inPEOEO 
I I 

Z22 I Device entry (entry nunber) I CDT'llD'Of 

I I 

123 I I 

I : ! 

127 | I 
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CDT'no'PRtv 

Entry nunber of the envious rapped denain entry for this device. 
COI'nO'NEKT 

Entry nunber of the ne»t napped donam entry for this device. 
CDT'nO'SECTOR 

The starting disc sector address representing this napped donain entry. 

CDT"ltrE»D'SEC T G8 

The ending disc sector address representing this nacped donain entry. 
COT'tlO'FinGS 

Flags describing the statt of this napped donain entry and the region as- 
sociated uith it: 

(0:1) - absent . 

Region is not present in -enory. 
(1:1) - inl- 

Region is already In-notion-ln. (Set uhen the fetch for 
this cached region is initiated). 
(2:1) - JM- 

Region is In-Botion-Out. (Set by STRRTOSJURITE uhen per- 
forming the background post of a cached region). 
(3:1) - niSS. 

This disc donain uas not present and had to be prefetched. 
(4:1) - LOCK. Hot used. 
(5:1) - FUIP. 

Forced Urite In Progress. Region uas forced out of renory 
to nake roon for another object. 

(6:1) - ROC. r 

Recover Overlay Candidate. Region nay be forced out of 
netiory to nake roon for another object. However, if this 
region is referenced again it can be recovered. 

(7:1) - VISCIH. 

Clean region in the write state. Cleared as soon as a nove 
conpletes. (I.e. if this bit is on, then a urite can con- 
plete mnediately. Otherwise the urite uill have to uait 
until the current urite conpletes the physical post). 

(8:0 - NCPOST. 

Set uhen the COT is being posted out as a result of a 
write request that did not uant to uait for the physical 
post to conplete. This uiil be cleared by the cache con- 
pletor uhen the physical post conpletes. (This is used to 
insure that a cache nove for any subsequent urite request 
uili not be serviced until the physical post conpletes. ) 

(9:1) - SE3- 

Set if doing sequential I/O. uhen the request for the 
last area of this disc donain is conplete, this donain 
uill be nade a ROC. 

(10:3) - Hot used. 

(13:3) - STATE 

0 - nVRIl. CDT is an available entry. 
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1 - REM). Only read IDR(e) are attached. 

2 - URITE. Urite LOR(s) and possibly read LDR(s) are 

attached. 

3 - FLUSH. CDT is being flushed out. 

4 - LOCK. Unused. 



CDT'nD'RERO'CHT 

The nunber of LDRs attached that are for reads (nove not conplete). 
CTT'im-UMTfCHT 

The nunber of LDRs attached that are for urites. NOTE: This count uill not 
be decremented until both the cache nove and the physical unte conpletes. 
Houever, as soon as the cache nove conpletes, the LOR uill be dequeued fren 
the CDT. 

Hot used. 
COT'nO'IUPED'HO 

The first LDR that is inpeded. (I.e. the CDT is in a urite state already and 
another write is attached. The second urite uill be placed in this queue un- 
til the first urite conpletes.) 

CDT'tWUM'HEIIO 

The first IDS that is on the active list for this CDT. 
COT'lW'nen'BODft 

The nenory address (region base) for this napped disc donain, if present. 

corno-DisciED 

The disc request table index associated uith this napped disc donain. This 
uill be used to fetch this region in, or to post this region after any logi- 
cal I/Os (urites) have conpleted. (I.e. this DRO is used for the physical 

I/O.) 

COT'nO'lK'CHT 
Hot used. 

eorno'LDEV 

The ldev nunber for this napped donain. 
COT'WinPEDeO 

The PIH for the first process inpeded on this napped disc donain. Processes 
get inpeded here uhen they do UMTFORIO uhen their LDR is on the CDT inpeded 
queue and *he Happed Donain is currently being written out. (This uill also 
happen upon a :S?0PCBC»E to force all LDRs to conplete.) Rs soon as the 
physical post of the Happed Donain is conplete, ail processes inpeded here 
uill be awakened. 



Logical Disc Request Table 



X1017 Pointer to Logical Disc Request Table 



NOTE: 



This tabla is really part of the ORS (Chapte- 13). P"y entry uith 
the logical request bit set in the flags will conform to this far- 
nit and not the femat of the standard 0R0. 



Logical disc requests entries are used to narage requests betueen the 
requesting process and a napped disc donain. They are the counterpart of 
disc requests entries used to nanage physical I/O requests betueen a process 
and a disc. These entries are kept as part of the DRH Table, but uill never 
be queued to the disc's DIT, instead they uill be queued to the napped disc 
donain CDT entry. LDfl entries nay only be placed onto the following queues: 

1) The CDT active list. 

2) The COT inpeded LDR list. 

3) The Disabled Disc Request. (This uill only happen if the buffer 
segnent is absent uhen the logical I/O (cache nove) is attenpted.) 



LDRs are singly linked onto the CDT queues and doubly linked 
onto the disabled disc request queue. 



COT'nO'DE 

The entry nunber 

sociated with. 



or the Device entry that this happed Oonain entry it as- 
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Logical Disc Request Entry 



111111 
8 9 0 1 2 3 4 5 



0 I//I S| II El 01 Dl SI CI m/| CI D| L| I| 
I//I Bl 0| L| Ol 0| El Dl 0|/l Ul I| D| N| 



I//I HI U| 0| K| 
I//I M fl| C| El P| 



Rl T| V|/| R| SI R| | 
II I l/l I HI | L| 



I//I I K| K| | Ol D| Ol Dl/I Rl Bl Rl 0| 



I//I I El El I SI 
I//I I I Dl I T | 
I//I I I I I I 



L| U| 0|/| El LI El C| 
I E| Nl/I HI El HI I 
I I El/I I D| | | 



HODfl of extent Unit 
Ldev 



napped Donain CDT entry nunber 
SI DST nunber 



5 I Offset into DST 

| 

6 I Strategy I Function 



I- 

7 I 
I- 
Z10 I 

I- 
Z11 I 

I- - - I 

212 I I Qualifier | Status I 

I 1 

Z13 I PIN nunber I 

| 1 

Z14 | Prev. LDR in queue (table relative) i 



Count/Xlog/Control returns 
P1 
P2 



I- 



-I 

Z1S | Next LDR in queue (table relative) I 

I 1 

11 6 | HODA of extent base j 



Z1? | 

I- 
Z20 I 



LODA of extent base 



LODB of extent linit 



LDR 'L' HODP. 

LDR' LDEV 

LDR' CDT 

LDR'BUFDST 

LDR'BUFfiDR 

LDR'STRAT'FUNC 

LDR' COUNT 

LDR'PARffl 

LDR'PBR[12 

LDR'STATQ 

LDR'PCB 

LDR'PREVQ 

LDR'NEXTQ 

LDR'O'HQDR 

LDR'B'LODfi 

LDR'L'LODfl 
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LDR 'FLAGS 

Flags. 

(0:3) - 

(3:1) - 

(4:1) - 

(5:1) - 

(6:1) - 

(7:1) - 

(8:1) - 

(9:1) - 

(10:1) - 



(11:1 
(12:1 

(13:1 

(14:1 

(15:1 



Not used. 
SBJJF. 

Set if request is to/fron a Systen Buffer. 
IOUBKE . 

Set if systen should wake up the process when the logical 
I/O conpletes. 
BLOCKED . 

Set if the process wants to wait for the logical disc 
request to conplete. 
DONE . 

Set when the logical disc request is conplete and the 
process Mill be awakened (if IOUflKE is set) 
DO'POST . 

Set if the caller wants to be waited until the physical 
post to disc conpletes. Only valid for urite requests. 
SERIPiL'POST . 

Set whan the physical post should be through the Global 
Serial Urite queue. 
CDT' QUEUED . 

This request has been queued - either onto the CDT active 
queue (see CDT Flapped Donain entries) or onto the disabled 
disc request list. 
ROVE 'DONE . 

The nave has been conpleted, but the process won't be 
awakened until the DONE bit is set. 
Not used. 
CUR'REQ . 

Set if this request is the current/active request. 
DISBBLE . 

Set if the request is disabled. 
LDR'REQ . 

Set if this is a logical disc request. 
LDR'INLOC . 

Set if Mapped Donain CDT entry is in process's locality 
list. 

LDR'L'KDDB 

The High Order Disc Address of the extent linit. (See note with LDR'B'HODfl). 
LDR' LDEV 

The ldev for this request. 
LDR 'CDT 

The CDT nunber for the Happed Donain entry associated uith this request. 
LDR'BUFDST 

Data Segnent nunber for the target of the logical I/O request. If bit zero 
is set, then this is the process's stack. 

LDR'BUFfiDR 

Offset within the DST (above) for the target address. If the DST is the 
process's stack, then this address will be DB relative. 
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Disc Caching 



LDR'STRBT'FUNC 

(0:8) - Strategy 

0 - Unknown caller 

1 - Unknoun File Systen 

2 - Spooler 

3 - Directory 
4-7- Unknoun caller 

8 - Gennessage 

9 - File Systen, Quiesce I/O 

10 - File Systen, Sequential, No Buf 

11 - File Systen, Direct, No Buf 

12 - File Systen, Sequential, Buffered 

13 - File Systen, Direct, Buffered 

14 - File Systen, KSAtl 

15 - File Systen, IHfiCE 

(8:8) - Function 

0 - Read 

1 - Urite 



LOR' COUNT 

On initiation, this specifies the requested transfer count (*words, -bytes), 
fit completion of the request, this contains the actual transnission count 
(tuords, -bytes). 

LDR'PDRm 

This is the High Order Disc Address of the requested disc sector. 
LDR'PfiRH2 

This is the Low Order Disc Address of the requested disc sector. 
LDR'STATQ 

Unifom status returns. 
LDR'PCB 

PIN of the requesting process. 
LDR'PREVQ 

Table relative index of the previous LDR in the queue. (NOTE: LDRs are sing- 
ly linked on the CDT queues, and doubly linked on the disabled disc request 
queue) . 

LDR'NEXTO 

Table relative index of the next LDR in the queue. 
LDR'B'HODA 

The High Order Disc Address of the extent base. (Used when the logical disc 
request is through the file systen. Caching uses this infornation when 
searching nenory for a "hit" on a cached donain). 

LDR'B'LODA 

The Lou Order Disc Address of the extent base. (See note above). 
LOR' L' LODA 

The Lou Order Disc Address of the extent linit. (See note above). 
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